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“计算 机 科学 领域 只 有 两 大 难题 : 缓存 失效 和 命名 。” 





写 一 本 关于 缓存 失效 的 书 并 不 是 难事 ， 难 的 是 如 何 给 书 取 个 合适 的 名 字 。 本 书 的 书 名 代表 
的 是 Web 开发 方方面面 的 变化 ， 这 些 变 化 促成 了 一 种 新 的 Web 应 用 设计 方法 的 诞生 。 





























诚然 ，Web 开发 的 许多 方面 都 可 以 称 为 “新 ”的 。 不 断 升级 的 桌面 浏览 器 、 层 出 不 穷 的 移 
动 终端 、 一 直 在 演变 的 编程 语言 、 更 快 的 处 理 器 ， 还 有 越 来 越 挑 剔 的 用 户 以 及 他 们 不 断 增 


长 的 、 对 易 用 性 禾 











H 交 互 性 的 期 望 ， 都 让 开发 者 枕 戈 待 旦 。 这 些 改变 使 开发 者 在 为 项 目 提供 





解决 方案 时 必须 持续 创新 。 而 其 中 的 许多 解决 方案 并 不 是 孤立 的 ， 它 们 有 更 为 深远 的 含义 。 

















因此 ， 为 了 响应 这 些 创 新 ， 我 选择 了 “客户 端 一 服务 器 端 ”这 一 术语 ， 它 在 许多 方面 都 反 








上 映 了 Web 开发 中 所 发 生 的 变化 。 时 下 流行 的 其 他 一 些 对 现代 化 开发 实践 的 描述 不 适用 于 


我 们 的 研究 领域 。 





这 里 所 讲 的 Web 应 用 开发 是 有 关 桌 面 浏 览 器 的 ， 另 一 个 日 渐 相 关 的 领 











域 一 一 移动 应 用 开发 ， 则 并 不 包括 在 内 。 


人 们 使 用 术语 单 页 面 应 用 或 单 页 面 界面 ， 来 区 分 现代 Web 应 用 和 早期 的 静态 网 页 。 这 些 术 
语 准确 地 抓 住 了 现代 Web 应 用 的 特征 ， 和 早期 应 用 相 比 ， 它 们 更 动态 ， 交 互 性 更 强 。 














当然 ， 很 多 现代 的 动态 网 站 并 不 是 单 页 面 应 用 ， 它 们 可 能 由 多 个 页 面 组 成 。 这 些 术语 强调 














的 是 页 面 一 一 一 个 应 用 的 客户 端 。 对 于 服务 器 端的 开发 ， 它 们 未 作 任 何 特 别 声 明 。 还 有 与 














高 度 动态 化 的 页 下 


i 相关 的 各 种 JavaScript 框架 (Angular、Ember 和 Backbone 等 )， 但 是 这 





些 仍然 是 客户 端的 事 。 我 希望 本 书包 含 的 内 容 更 广 ， 不 局 限于 前 端的 创新 ， 还 应 涵盖 服务 








器 端的 相关 设计 条 


Web 服务 信息 传递 。 


这 就 是 流行 的 REST (Representational State Transfer) 技术 ， 它 建议 了 一 种 Web 服务 消息 传 
递 的 风格 。 但 是 REST 的 作者 罗 伊 * T. 非 尔 本 (Roy Fielding) 只 给 出 了 有 限 的 定义 ， 在 个 


xiii 


人 博客 中 ， 他 列 出 了 自称 为 “RESTful APIs”"、 却 常常 违反 REST 风格 的 几 个 错误 (http:/ 
roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven)。 还 有 人 在 StackOverflow 上 
发 帖 提 问 JSON API 是 否 是 真正 的 REST 式 (http://stackoverflow.com/questions/9055197/ 
splitting-hairs-with-rest-does-a-standard-json-rest-api-violate-hateoas)， 因 为 JSON 并 不 完全 满 
足 REST 结构 风格 的 约束 。 对 于 REST 服务 ， 有 一 种 渐进 式 描述 (http://martinfowler.com/ 
articles/richardsonMaturityModel.html) ， 即 只 有 当 API 满足 相应 程度 的 约束 时 才 可 称 为 REST 
式 。REST 将 客户 端 -服务 器 端 架 构 、 动 词 的 使 用 和 URL 的 命名 规范 也 作为 其 约束 。 








使 用 JavaScript 客户 端 处 理 实用 的 “REST 式 ”API 产生 的 消息 是 开发 方法 中 重要 的 一 环 ， 
那么 服务 器 端的 情况 是 怎么 样 的 ? 


Java 企业 版 (JEE) 包含 了 JAX-RS API (http://docs.oracle.com/javaee/6/tutorial/doc/giepu. 
html) ， 它 是 一 种 Java 风格 的 REST (但 没有 严格 遵循 REST 规范 )， 并 使 用 了 Jersey 作为 
一 种 参考 实现 予以 展示 。 如 果 仅 限于 使 用 JAX-RS 开发 Web 应 用 ， 则 会 忽略 一 些 现 有 的 框 
架 和 其 他 一 些 基 于 JVM 的 编程 语言 所 提供 的 解决 方案 (尤其 擅长 快速 搭建 原型 )。 


为 一 本 书 起 一 个 简单 明了 、 引 人 入 胜 的 书 名 并 不 容易 ， 多 亏 了 James Ward (www. 
jamesward.com)， 他 在 2012 年 的 OSCON 大 会 上 发 表 了 一 篇 题 为 “Client-Server Web 
Applications with HTMLS5 and Java” 的 演讲 。 在 这 篇 演讲 中 ， 他 列举 了 一 种 正在 变 得 流行 
的 Web 应 用 开发 方法 的 优点 ， 在 近 些 年 的 一 些 项 目 中 ， 我 也 使 用 了 这 种 方法 开发 Web 应 
用 。 甚 中， 术语 “客户 端 - 服 务 器 端 ” 是 理解 这 种 开发 方法 的 关键 ， 它 概括 了 软件 架构 的 
根本 性 改变 ， 对 客户 端 和 服务 器 端 做 出 了 明确 区 分 ， 并 将 两 者 放 在 了 同样 重要 的 位 置 上 。 
























































Web 应 用 的 这 种 客户 端 一 服务 器 端 架构 带 来 了 程序 员工 作 方式 的 转变 〈 有 时 候 ， 甚 至 是 天 
翻 地 覆 的 变化 )。 本 书 就 是 为 了 帮助 开发 者 适应 这 种 章 命 而 写 的 ， 特 别 是 对 于 如 何 构 建 现 
代 Web 应 用 的 最 新 方法 方面 ， 也 做 出 了 恰当 的 评价 。 


目标 读者 

本 书 的 目标 读者 是 那些 熟悉 Java、HTML、JavaScript 和 CSS 的 Web 应 用 开发 者 。 它 是 为 
那些 喜欢 在 实践 中 学 习 ， 喜 欢 将 新 技术 集成 进 标准 工具 中 构建 示例 应 用 的 读者 而 量 身 定制 
的 。 如 果 你 想 了 解 JavaScript 的 最 新 发 展 ， 以 及 和 使 用 Java 在 开发 流程 上 的 异同 ， 那 么 请 
阅读 本 书 。 

阅读 本 书 ， 你 需要 在 两 方面 之 间 做 平衡 。 一 方面 ， 读 者 从 本 书 中 能 得 到 的 最 大 收获 是 从 安 
观 上 掌握 技术 转变 的 影响 和 趋势 ， 另 一 方面 ， 理 解 技术 的 最 好 途径 往往 是 具体 的 例子 。 如 
果 你 的 兴趣 在 于 从 宏观 上 掌握 各 种 技术 之 间 是 如 何 融 合 在 一 起 ， 那 么 定 能 从 本 书 中 受益 。 
我 写作 此 书 的 目的 ， 就 是 帮助 读者 做 出 明智 的 决定 。 好 的 决定 可 以 帮助 你 在 新 项 目 中 采用 
正确 的 技术 ， 避 免 因 采用 不 相 容 的 技术 造成 的 陷 了 哇 ， 或 者 对 给 出 的 决定 形成 错误 的 预期 。 































































































它 还 能 帮助 你 在 正 开 发 的 项 目 里 快速 上 手 ， 更 好 地 支持 已 有 代码 。 简 言 之 ， 明 智 的 决定 可 
以 让 程序 员 的 工作 效率 更 高 ， 它 能 让 你 在 当前 ， 或 者 是 未 来 工作 中 研究 感 兴趣 的 领域 时 高 
效 地 利用 时 间 。 


本 书 内 容 


第 1 章 概 览 了 客户 端 - 服 务 器 端的 Web 应 用 架构 ， 介 绍 了 Web 应 用 开发 的 历史 ， 并 为 
Web 开发 范式 的 迁移 提供 了 充足 的 证 据 。 由 此 引出 了 接 下 来 的 三 章 内 容 ， 分 别 描述 了 开发 
过 程 中 各 种 工具 的 使 用 。 

















第 2 章 介 绍 了 JavaScript 语言 ， 以 及 使 用 JavaScript 进行 开发 时 用 到 的 工具 。 


第 3 章 介绍 了 如 何 设计 Web API、REST， 以 及 开发 基于 HTTP 的 REST 式 应 用 时 用 到 的 工具 。 





第 4 章 介绍 了 Java， 以 及 本 书 剩余 章节 内 容 需 要 用 到 的 软件 。 


本 书 的 第 二 部 分 探讨 了 更 高 级 的 结构 (比如 客户 端 类 库 和 应 用 服务 器 )， 以 及 它们 如 何 做 
到 良好 的 分 离 ， 从 而 方便 快速 开发 。 














第 5 章 介 绍 了 主流 的 客户 端 JavaScript 框架 。 
第 6 章 介 绍 了 Java API 服务 器 和 服务 。 
第 7 章 介绍 了 快速 开发 实践 。 

8 章 深入 讨论 了 API 设计 。 


对 这 些 类 库 和 快速 开发 原型 的 流程 有 所 了 解 之 后 ， 在 接 下 来 的 儿童 中 ， 我 们 将 这 些 知 识 应 
用 于 具体 的 项 目 ， 使 用 各 种 基于 JVM 的 语言 和 框架 。 在 接 下 来 的 两 章 中 ， 我 们 使 用 了 轻 
量 级 的 Web 服务 器 和 微 框架 ， 而 没有 采用 传统 的 Java Web 应 用 所 需 的 打包 方式 和 服务 器 。 














第 9 章 介 绍 了 一 个 使 用 jQuery 和 Jython 的 项 目 。 
第 10 章 介 绍 了 一 个 使 用 JRuby 和 Angular 开发 的 项 目 。 


本 书 的 最 后 几 章 详细 介绍 了 几 个 使 用 传统 的 Java Web 应 用 服务 器 和 类 库 的 项 目 。 





第 11 章 介绍 了 Java 生态 系统 中 现 有 的 Web 应 用 打包 方式 和 部 署 选 项 。 

第 12 章 介绍 了 虚拟 化 和 在 管理 大 规模 服务 器 环境 中 涌现 出 的 新 技术 。 

第 13 章 将 焦点 放 在 了 测试 和 文档 化 上 。 

第 14 章 对 全 书 做 总 结 ， 并 对 互联 网 相关 技术 和 软件 开发 中 各 种 纷繁 的 变化 给 出 了 看 法 。 
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附录 A 介绍 了 如 何方 便 地 与 Java 类 交互 。 


排版 约定 
本 书 使 用 的 排版 约定 如 下 所 示 。 
。 楷体 
表示 新 的 术语 。 
要 等 宽 字 体 (Constant width ) 
表示 程序 片段 ， 也 用 于 在 正文 中 表示 程序 中 使 用 的 变量 、 方 法 名 、 命 令 行 代码 等 元 素 。 
。 等 宽 粗 体 (Constant width bold) 


表示 示例 中 的 新 代码 。 


。 等 宽 和 斜体 (Constant width italic) 
表示 应 该 由 用 户 输入 的 值 或 根据 上 下 文 确定 的 值 替 换 的 文本 。 





这 个 图 标 表示 提示 、 建 议 或 重要 说 明 。 

















使 用 代码 示例 


你 可 以 在 这 里 下 载 本 书 随 附 的 资料 (项目 、 代 码 示例 等 ) : https:/github.conyjavajavascript/ 
client-server-web-apps。 你 可 以 在 线 查 看 ， 或 者 下 载 其 压缩 文件 以 在 本 地 使 用 。 其 中 资源 是 
按 章 划 分 的 。 


本 书 示例 代码 仅 作 展示 特定 功能 之 用 ， 不 求全 面 展示 一 个 功能 完整 的 应 用 ， 具 体 区 别 
如 下 。 








产品 级 的 系统 要 对 数据 类 型 、 验 证 规则 、 蜡 常 处 理 例 程 和 日 志 做 很 大 的 改进 。 


大 多 数 产品 级 系统 都 会 在 后 台 包 含 若干 个 数据 存储 。 为 了 限制 讨论 范围 ， 大 多 数 示例 都 未 
牵扯 数据 库 。 








| 前 言 





现代 Web 应 用 有 很 大 一 部 分 面向 移动 设备 ， 而 且 要 考虑 浏览 器 兼容 性 。 除 非 讨 论 到 这 些 主 
题 ， 否 则 我 们 会 避免 响应 式 设计 (http://en.wikipedia.org/wiki/Responsive_web_design)， 而 
只 提供 一 个 最 简化 的 设计 。 


























不 可 见 JavaScript (unobtrusive JavaScript， 参 见 http://en.wikipedia.org/wiki/Unobtrusive_JavaScript) 
将 CSS、JavaScript 和 HTML 分开， 是 一 种 被 广泛 接受 的 最 佳 实践 。 然 而 在 本 书 的 示例 代 
码 中 ， 它 们 常常 被 混在 一 起 ， 这 是 因为 对 一 个 应 用 来 说 ， 仅 从 一 个 文件 就 可 宁 视 其 奥秘 。 


单元 测试 和 测试 代码 示例 只 在 和 所 讨论 主题 直接 相关 时 才 被 包括 进来 。 产 品级 的 系统 往往 
包含 大 量 的 测试 。 


让 本 书 助 你 一 璧 之 力 。 也 许 你 需要 在 自己 的 程序 或 文档 中 用 到 本 书 中 的 代码 ， 但 除非 大 篇 
幅 地 使 用 ， 和 否则 不 必 与 我 们 联系 取得 授权 。 例 如 ， 用 本 书 中 的 几 段 代码 编写 程序 无 需 请 求 
许可 ， 但 是 销售 或 者 发 布 O'Reilly 图 书 中 代码 的 光盘 则 必须 事先 获得 授权 ， 引 用 书 中 内 容 
或 代码 来 回答 问题 也 无 需 获 得 授权 ， 但 将 大 量 示例 代码 整合 到 你 自己 的 产品 文档 中 则 必须 
经 过 许可 。 


使 用 我 们 的 代码 时 ， 和 希望 你 能 标明 它 的 出 处 ， 但 我 们 并 不 强求 。 出 处 信息 一 般 包 括 书 
名 、 作 者 、 出 版 商 和 书号 ， 例 如 : Client-Server Web Apps with JavaScript and Java, Casimir 
Saternos (O’Reilly). Copyright 2014 EzGraphs, LLC., 978-1-449-36933-0。 





















































如 果 还 有 关于 使 用 代码 的 未 尽 事宜 ， 请 随时 与 我 们 联系 : permissions@oreilly.com。 


对 长 命令 的 格式 化 

对 于 长 命令 ， 我 们 要 做 适当 的 调整 以 方便 大 家 阅读 。 在 操作 系统 里 有 一 个 约定 俗 成 的 规 
则 ， 即 使 用 反 斜 杠 插入 新 行 。 比 如 ， 下 面 的 两 个 命令 是 等 价 的 ， 在 bash 中 执行 结果 是 一 样 
的 。(bash 是 一 种 标准 的 操作 系统 shell， 当 你 使 用 命令 行 访问 Linux 服务 器 或 Mac OS X 系 
统 时 就 会 用 到 。) 





ls -L *someVeryLongName* 
1Ls -LAN 
*someVeryLongName* 


这 种 规则 在 其 他 用 到 操作 系统 命令 的 环境 下 也 适用 ， 比 如 Dockerfiles。 
同样 ， 合 法 的 JSON 字符 串 也 可 以 分 成 多 行 ; 





o={"name": "really Long string here and includes many words"} 





// 如 大 家 期 望 的 那样 ， 下 面 的 语句 结果 为 真 


JSON.stringify(0)=='{"name":"really Long string here and includes many words"}' 























// 同样 的 字符 串 ， 分 成 多 行 的 结果 是 一 样 的 ， 因 此 下 面 的 结果 也 为 真 
JSON.stringify(0o)=='{"name":' + 

'"some really Long ' + 

'JSON string is here' + 

' and includes many, many words"}' 
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Safari Books Online (http:/www.safaribooksonline.com) 是 应 需 
Safa 队 生硬 变 的 数字 图 书馆 。 它 同时 以 图 书 和 视频 的 形式 出 版 世界 顶级 
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因 变 而 变 





“企业 家 总 在 寻求 变化 ， 他 们 适应 变化 ， 并 把 它 当 作 一 次 机 遇 。” 
一 一 彼得 . 德 鲁 克 ,，“ 现 代 管 理学 之 父 ” 


是 怎样 的 变化 促使 开发 者 采用 客户 端 - 服务 器 端的 架构 ”用户 行 为 、 技 术 和 软件 开发 流程 
的 变迁 是 其 中 最 重要 的 原因 ， 它 们 促使 开发 者 改变 过 去 的 设计 模式 。 这 其 中 的 每 个 因素 ， 
都 在 以 自己 独特 且 有 效 的 方式 让 已 有 的 模式 不 合 时 宜 。 它 们 一 起 激励 了 相关 领域 的 创新 ， 
虽然 没有 强制 标准 化 ， 但 是 在 实践 中 ， 人 们 的 开发 方式 正在 趋同 。 


用 户 变 了 。 早 期 的 Web 用 户 满足 于 静态 页 面 和 最 基本 的 用 户 界面 ， 而 现在 的 用 户 期 待 的 是 
高 性 能 、 可 交互 、 精 心 设计 的 动态 体验 。 大 量 新 技术 的 涌现 和 浏览 器 能 力 的 扩展 满足 了 用 
户 的 期 待 。 现 在 的 Web 开发 者 需要 使 用 工具 和 新 的 开发 方式 ， 以 适应 现代 Web 应 用 的 使 
用 场景 。 


技术 变 了 。 浏 览 器 和 JavaScript 引擎 变 得 更 快 。 台 式 机 和 笔记 本 性 能 更 强 ， 更 不 用 说 无 数 
的 移动 设备 现在 也 用 来 网 上 冲浪 了 。Web 服务 API 再 也 不 是 一 个 可 有 可 无 的 功能 ， 而 是 人 
们 对 现代 Web 应 用 一 个 再 也 正常 不 过 的 期 望 。 云 计算 彻底 颠覆 了 Web 应 用 的 部 署 和 运作 。 


软件 开发 方式 变 了 。 流 行 的 “敏捷 宣言 ” 提 人 
。 个 体 和 互动 高 于 流程 和 工具 ， 

。 工作 的 软件 高 于 详尽 的 文档 ， 

。 客户 合作 高 于 合同 谈判 ， 

。 响应 变化 高 于 遵循 计划 。 
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现在 ， 让 Web 应 用 先 快 跑 起 来 变 成 可 能 至 少 在 小 范围 内 ， 可 以 验证 技术 的 可 行 
性 。 搭 建 原型 价值 非 几 。 正 如 《人 月 神话 》(The Mythical Man Month, Addison-Wesley 
Professional) 的 作者 Fred Brooks 那 句 名 言 所 说 :“ 准 备 着 扔 掉 一 个 吧 ， 无 论 如 何 ， 你 都 会 
这 样 干 的 。” 原型 让 早期 客户 或 用 户 参 与 交互 ， 帮 助 在 前 期 确定 需求 。 花 几 分 钟 时 间 编 写 
一 个 能 工作 的 Web 应 用 已 经 不 是 什么 不 可 能 的 事 了 。 












































1.1 Web 用 户 
对 如 何 与 现代 Web 应 用 交互 ， 用 户 的 需求 是 明确 的 : 


。 Web 应 用 需 能 中 平台 访问 ， 
。 Web 应 用 需 在 不 同 平台 上 提供 一 致 的 用 户 体验 ， 
。 Web 应 用 需 响应 及 时 ， 没 有 延迟 。 


高 德 纳 集 团 (http:/www.gartner.com/newsroom/id/1947315) 声称 ， 个 人 云 服务 将 在 2014 年 
取代 PC 机 成 为 人 们 数字 生活 的 中 心 。 这 对 Web 应 用 的 开发 来 说 有 多 层 含义 。 用 户 更 加 热 
衷 科技 ， 对 网 站 的 响应 速度 有 更 高 的 期 待 。 他 们 不 像 过 去 那些 年 一 样 被 动 接受 ， 转 而 参与 
其 中 并 互动 。 网 站 需要 设计 得 看 不 出 浏览 器 的 局 限 ， 提 供 像 原生 应 用 一 样 的 用 户 体验 。 




















用 户 希 望 应 用 以 多 种 方式 提供 服务 ， 在 不 同 环境 下 均 可 使 用 。 响 应 式 设计 、 多 浏览 器 、 多 
平台 和 多 设备 支持 已 经 成 为 新 的 常态 。 为 了 支持 多 样 的 客户 端 ， 使 用 JavaScript 类 库 和 相 
架 至 关 重 要 。 


TH 








《纽约 时 报 》 最 近 报 道 了 Web 用 户 对 网 站 响应 时 间 的 忍耐 度 (http://www.nytimes. 
com/2012/03/01/technology/impatient-web-users-flee-slow-loading-sites.html?pagewanted=all&_ 
r=0)。 他 们 发 现 ， 如 果 某 公司 网 站 的 访问 速度 比 直 接 竞 争 对 手 的 慢 250 毫秒 ， 那 么 访问 量 
就 会 相对 少 很 多 。 在 开发 Web 应 用 时 ， 我 们 需要 将 性 能 视 作 一 个 关键 的 考虑 因素 。 


1.2 技术 


使 用 Java 开发 Web 应 用 的 开发 者 ， 一 般 都 熟悉 服务 器 端的 动态 内 容 生 成 。J2EE 和 JSP 经 
过 完善 ， 变 成 了 JEE 和 JSF。 诸 如 Spring 这 样 的 框架 为 服务 器 端 开 发 提供 了 额外 的 功能 。 
在 Web 应 用 的 早期 ， 页 面相 对 来 说 更 静态 化 ， 服 务 器 的 速度 相对 更 快 ，JavaScript 引擎 很 
慢 ， 处 理 浏览 器 兼容 性 的 类 库 和 技术 也 很 少 ， 这 种 开发 模型 就 是 合情合理 的 。 


与 乙 相 比 ， 现 在 的 客户 端 -服务 器 端 架 构 里 ， 服 务 器 更 大 程度 上 负责 响应 客户 端 请 求 ， 
提供 资源 的 访问 方式 (通常 使 用 XML 或 者 JSON 交换 信息 ) 。 在 过 去 的 服务 器 驱动 模型 
里 ， 页 面 《 和 与 之 相关 的 数据 ) 都 在 服务 器 端 生 成 完毕 ， 一 起 返回 客户 端 在 浏览 器 里 演 
染 。 而 在 客户 端 - 服务 器 端 架构 里 ， 服 务 器 先 返 回 一 个 包含 少量 数据 的 初始 页 面 。 用 户 
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和 页 面 交 互 时 ， 页 面向 服务 器 端 发 起 异步 请 求 ， 服 务 器 端 则 返回 消息 ， 以 使 页 面 刷 新 来 
响应 这 些 事件 。 








刚 开 始 的 Web 开发 主要 是 创建 静态 HTML 网 站 ， 之 后 加 入 了 服务 器 端 处 理 (CGI、Java 
Servlets) ， 为 网 站 注入 了 动态 内 容 。 慢 慢 地 ， 人 们 开始 使 用 更 加 结构 化 的 语言 ， 集 成 了 服 
务 器 端 模板 (ASP、PHP、JSP) 和 MYVC 框架 。 新 近 出 现 的 技术 继续 沿 着 传统 的 路 子 ， 增 
加 了 这 样 那样 的 抽象 。 


为 了 向 开发 者 屏蔽 设计 和 Web 的 底层 架构 ， 组 件 化 的 框架 出 现 了 。 先 是 出 现 了 标签 库 ， 然 
后 是 组 件 化 ， 几 种 流行 的 框架 都 采用 了 组 件 化 的 方式 : 











。 Java Server Faces(JSF) 是 一 种 基于 XML 的 模板 系统 和 组 件 化 框架 ,导航 实行 集中 化 配置 
。 Google Web Toolkit 是 另 一 种 组 件 化 框架 ， 它 发 挥 了 Java 程序 员 的 长 处 ， 让 他 们 集中 精 
力 编写 Java 代码 ， 而 不 需要 直接 修改 HTML、CSS 和 JavaScript。 











每 一 种 框架 都 有 它 的 作用 ， 被 成 功 应 用 于 生产 系统 。 但 是 ， 和 很 多 试图 屏蔽 底层 复杂 性 的 
方案 一 样 ， 当 你 需要 更 多 的 控制 权 (比如 想 要 集成 大 量 的 JavaScript 代码 ) ， 或 者 不 满足 
使 用 框架 的 前 提 条 件 ( 比 如 可 用 服务 器 会 话 ) 时 ， 就 出 问题 了 。Web 的 基本 架构 是 使 用 
HTTP 请 求 - 响应 协议 的 一 种 客户 端 - 服务 器 端 计算 模 型 ， 而 这 些 方案 却 试图 去 屏蔽 它 。 


浏览 器 端的 创新 也 促成 了 责任 从 服务 器 端 向 客户 端的 转移 。20 世纪 90 年 代 后 期 ， 微 软 
开发 了 后 来 成 为 Ajax (Jesse James Garrett 于 2005 年 2 月 18 日 命名 了 这 一 术语 ) 的 底层 
技术 。Ajax 是 “asynchronous JavaScript and XML” 的 缩写 ， 但 是 对 各 种 Web 页面 和 服务 
器 进行 通信 的 技术 也 都 适用 。 这 种 技术 允许 少量 信息 传递 ， 这 样 在 设计 基于 JavaScript 的 
Web 应 用 时 ， 可 以 更 好 地 利用 带宽 。 处 理 器 的 升级 和 JavaScript 引擎 的 优化 显著 地 提升 了 
浏览 器 性 能 ， 因 此 将 更 多 工作 从 服务 器 端 搬 到 浏览 器 端 也 变 得 顺理成章 。 用 户 界 面 的 响应 
速度 被 带 向 了 一 个 新 高 度 。 

移动 设备 的 浏览 器 更 进一步 促使 了 客户 端 代码 和 服务 器 端的 分 离 。 有 时 候 ， 我 们 可 以 创建 
出 设计 良好 的 响应 式 Web 应 用 。 如 果 不 行 ， 对 所 有 的 客户 端 设备 都 使 用 一 致 的 API 这 一 
点 也 是 很 吸引 人 的 。 

































































罗 伊 :T. 菲 尔 丁 于 2000 年 发 表 的 博士 论文 ， 让 Java EE 6 与 过 去 基于 组 件 的 API 设计 背 道 
而 驰 。 人 们 设计 出 了 JAX-RS (Java API for RESTful Web Services) 和 Jersey (一 个 “产品 
级 的 参考 实现 ”)， 用 来 创建 使 用 REST 式 风格 通信 的 客户 端 - 服务 器 端 架构 。 


1.3 软件 开发 


过 去 ， 建 立 一 个 新 的 Java 项 目 相当 费 事 。 大 量 的 配置 选项 让 人 不 胜 其 烦 ， 而 且 容 易 出 错 。 
几乎 没有 自动 化 ， 人 们 假设 每 个 项 目 都 不 一 样 ， 开 发 者 各 有 各 需要 满足 的 需求 。 
































后 来 的 一 些 创新 ， 让 建立 项 目 变 得 简单 很 多 。 "约定 优 于 配置 ”是 来 自 Ruby on Rails 社区 
的 艇 言 。Maven (http://www.bit.ly/MLOLbU) 和 其 他 一 些 Java 项 目 也 选择 了 有 意义 的 默认 
配置 ， 并 为 一 些 常用 案例 提供 了 快速 创建 方式 。 


JVM 之 上 出 现 的 各 种 脚本 语言 绕 过 了 Java 严格 的 类 型 检查 ， 加 快 了 开发 过 程 。Groovy、 
Python (Jython) 和 Ruby 都 是 弱 类 型 语言 ， 完 成 同样 的 功能 需要 的 代码 量 更 少 。 还 有 称 为 
微 框架 的 Sinatra 和 Play， 它 们 提供 了 最 小 化 的 领域 专用 语言 (DSL)， 用 来 快速 编写 Web 
应 用 和 服务 。 时 至 今日 ， 在 开发 环境 中 建立 一 个 最 小 化 的 Web 服务 已 经 不 是 什么 难事 。 


采用 瀑布 式 开 发 的 大 型 软件 项 目 失败 的 案例 已 经 不 胜 枚 举 ， 这 充分 说 明 为 最 终 产 品 搭建 一 
个 小 型 原型 有 很 多 优势 。 搭 建 原型 有 以 下 几 个 目的 : 














二 




















。 验证 项 目的 技术 基础 ， 
。 为 不 同 技术 搭建 桥梁 ， 将 它们 纳入 同一 结构 ， 

。 让 最 终 用 户 和 系统 交互 ， 明 确 系统 用 途 和 用 户 界面 设计 ， 
。 让 系统 设计 师 明确 接口 和 系统 之 间 传 递 信息 的 数据 结构 ; 
。 让 程序 员 能 在 应 用 的 各 个 部 分 并 行 工作 。 


























原型 还 有 很 多 优点 ， 如 下 。 


。 原型 是 具体 的 、 实 实在 在 的 ， 它 们 代表 了 待 设计 的 最 终 系统 。 因 此 ， 原 型 融入 了 本 应 存 

在 于 设计 文档 、 图 表 和 其 他 介质 〈 常 常 散 见于 更 随意 的 场合 ， 比 如 电子 邮件 ， 或 人 们 在 
饮水 机 旁 的 闲谈 ) 的 信息 。 

。 原型 是 具体 的 实现 。 因 此 ， 它 们 代表 了 真实 的 需求 。 这 便于 人 们 更 好 地 理解 收集 上 来 的 
需求 ， 并 且 确 定 哪些 地 方 需要 进一步 明确 。 

。 原型 能 迅速 暴露 可 能 失败 的 地 方 。 在 具体 实现 前 ， 失 败 并 不 是 显而易见 的 。 

。 上 述 优点 能 更 好 地 帮助 人 们 理解 究竟 要 做 什么 ， 这 样 就 会 有 更 好 的 预测 和 计划 。 

由 于 客户 端 和 服务 器 端 分 工 明 确 ， 在 搭建 原型 开发 客户 端 - 服务 器 端的 Web 应 用 时 可 以 

发 挥 很 大 的 作用 。 开 发 客户 端的 可 以 使 用 服务 器 端的 原型 (反之 亦 然 )， 这 样 就 可 以 并 行 

开发 。 即 使 不 并 行 开发 ， 这 样 也 能 快速 模拟 对 服务 器 端的 调用 ， 方 便 开发 客户 端 代码 。 






































1.4 哪些 没 变 
Web 的 本 质 没 有 变 (还 是 基于 HTTP 进行 消息 传递 的 客户 端 一 服务 器 端 架 构 )。 


新 技术 并 没有 改变 一 切 。 高 级 编程 语言 没有 抹 去 了 解 操作 系统 的 需要 ， 对 象 -关系 映射 框 
架 也 没有 抹 去 了 解 关系 型 数据 库 和 SQL 的 需要 。 同 样 地 ， 在 开发 Web 应 用 时 ， 人 们 一 直 
试图 效仿 桌面 应 用 ， 想 忽略 Web 的 底层 架构 。 



































介质 特殊 性 
介质 特殊 性 是 出 现在 美学 与 当代 艺术 批评 中 的 词汇 ， 但 是 对 技术 也 适用 。 它 隐 含 了 对 
于 给 定 的 艺术 主题 ， 需 要 使 用 特定 介质 来 表达 的 合理 性 。 这 个 观点 由 来 已 久 ， 苞 特 堆 
尔 德 . 埃 夫 莱 姆 。 菜 辛 在 《 拉 奥 孔 》(Laocoom: An Essay Upon the Limits of Painting and 
Poetry) 一 书 中 这 样 写 道 : 
物体 连同 它们 看 得 见 的 属性 是 绘画 所 特有 的 题材 ， 动 作 是 诗 所 特有 的 题材 。， 
论 诗 与 画 的 界限 





当代 艺术 作品 通常 挑战 艺术 上 的 传统 限制 。 技 术 是 一 项 创新 性 活动 ， 但 我 们 关注 的 是 
可 用 的 系统 ， 而 不 是 抽象 的 美 。 介 质 无 关 性 之 所 以 重要 ， 是 因为 如 果 忽略 了 平台 的 本 
质 ， 则 最 终 系统 要 么 不 能 以 最 优 的 方式 工作 ， 要 么 根本 不 能 工作 。 这 在 很 多 技术 领域 
已 经 是 显而易见 的 事 。 本 书 的 目的 是 提倡 遵循 Web 本 身 的 设计 方式 来 设计 Web 应 用 。 
由 于 它 遵循 了 Web 的 基本 限制 ， 而 不 是 去 忽略 它 ， 这 样 的 Web 应 用 才能 更 好 地 工作 。 





1 节选 自 朱 光 潜 的 《 拉 奥 孔 》 译 本 。 一 一 译 者 注 
2 “ 论 诗 与 画 的 界限 ”是 《 拉 奥 孔 》 译 本 的 副标题 。 一 一 译 者 注 














1.4.1 Web 的 本 质 


Web 的 本 质 没 有 变 。 它 依然 由 服务 器 和 客户 端 构成 ， 通 过 HTTP 协议 ， 服 务 器 向 客户 端 提 
供 HTML 文档 ， 如 图 1-1 所 示 。 








HTTP 请 求 
请 求 SN 


4 I 
HTTP 请 求 N 
We 


运行 浏览 器 运行 
的 客户 端 的 


b 服 务 








行 
服务 器 








1-1: HTTP 请 求 和 响应 


客户 端 - 服务 器 端的 Web 应 用 架构 更 贴 合 Web 本 身 的 架构 。 虽 然 与 协议 无 关 ，REST 是 
基于 HTTP 开发 的 ， 也 和 HTTP 结合 在 一 起 使 用 。 从 本 质 上 说 ，REST 定义 了 使 用 HTTP 
的 限制 。 它 试图 描述 一 种 设计 良好 的 Web 应 用 : 该 应 用 是 可 靠 的 ， 运 行 良好 ， 可 扩展 ， 设 
计 优 雅 ， 而 且 方 便 修改 (如 图 1-2 所 示 )。 











REST 请 求 
服务 器 (Java 


REST 响 应 Web 服 务 ) 














1-2: REST 请 求 和 响应 














EN 











事实 上 ， 为 了 更 准确 地 强调 现代 Web 环境 中 的 挑 成 ， 我 们 还 要 考虑 多 设备 和 云 部 署 ， 如 
1-3 所 示 。 









-ss 














1-3: 多 设备 和 云 部 署 


在 Web 开发 (尤其 是 组 件 框架 ) 中 ，Web 的 无 状态 、 客 户 端 -服务 器 端 结构 的 本 质 ， 成 
了 被 忽略 的 “介质 特殊 性 。 


1.4.2 ”为 什么 说 服务 器 驱动 的 Web 开 发 有 害 

具备 某 种 功能 ， 不 意味 着 要 使 用 该 功能 。 在 很 多 情况 下 ， 服 务 器 驱动 、 基 于 组 件 的 Web 开 
发 方式 都 应 被 客户 端 - 服务 器 端的 架构 替换 。 服 务 器 驱动 的 方式 模糊 了 Web 的 本 质 ， 它 
本 身 就 是 一 种 架构 于 HTTP 协议 之 上 的 客户 端 - 服务 器 端 模型 。 忽 略 或 模糊 Web 的 本 质 ， 
会 让 开发 、 调 试 和 支持 软件 系统 变 得 更 难 。 服 务 器 驱动 的 Web 原本 是 为 了 让 Web 变 得 更 
容易 理解 ， 但 这 一 意愿 很 快 在 所 有 正式 的 系统 (需要 对 其 具备 的 功能 和 工作 方式 有 清晰 理 
解 的 系统 ) 里 被 打破 。 















































被 认为 是 有 害 的 
1968 年 ，Edsger W. Dijkstra 发 表 了 一 封 题 为 “Go To 语 自 被 认为 是 有 害 的 ”(Go To 
Statement conidered Harmful) 的 公开 信 。 这 封 信 很 有 趣 ， 除 了 对 结构 式 编程 中 减少 使 
用 goto 语句 造成 很 大 影响 ， 它 还 把 “被 认为 是 有 害 的 ”(considered harmful) 这 一 说 
法 带 入 到 极 客 文化 中 。Tom Christiansen 认为 使 用 csh 编程 是 有 害 的 (http://harmful. 
cat-v.org/software/csh) ，Douglas Crawford (道格拉斯 。 克 罗 克 福 德 ) 发 表 了 一 篇 题 为 
“with 语 身 是 有 害 的 ”( “with Statement Considered Considered Harmful”， 参 见 http:// 
yuiblog.com/blog/2006/04/11/with-statement-considered-harmful/) 的 博文 。 该 说 法 还 见于 
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其 他 地 方 ， 包 括 Eric A. Meyer 发 表 的 那 篇 风趣 的 自我 指 涉 的 文章 “被 认为 是 有 害 的 ” 
系列 文章 是 有 害 的 ”(““Considered Harmful ”Essays Considered Harmful”， 参 见 http:// 
meyerweb.com/eric/comment/chech.html) ， 而 且 可 以 想见 ， 这 个 说 法 还 会 不 停 地 出 现 。 
尽管 “被 认为 是 有 害 的 ”这 类 博 人 眼球 的 文章 质量 上 参差 不 齐 ， 但 其 都 有 一 个 合理 的 
共识 : 具有 一 种 语言 特性 或 一 个 技术 解决 方案 ， 不 过 这 并 不 表示 它 是 好 的 、 长 久 的 解 
决 方案 。 


1.5 为 什么 需要 客户 端 - 服 务 器 端的 Web 应 用 


在 Web 开发 中 ， 客 户 端 - 服务 器 端的 架构 有 很 多 优点 。 


1.5.1 代码 组 织 结构 /软件 架构 

将 代码 按 逻 辑 解 耦 的 好 处 很 明显 ， 它 增强 了 原 有 结构 和 后 续 支 持 系 统 的 内 聚 性 。 将 客户 
端 和 服务 器 端 分 层 ， 这 可 以 让 代码 变 得 可 管理 、 模 块 化 。 另 外 ， 数 据 和 显示 标记 能 更 清 
上 晰 地 分 离 。 可 以 使 用 JSON 而 不 是 内 骨 的 方式 发 布 数据 ， 这 和 现代 JavaScript 的 不 可 见 
JavaScript 概念 是 一 致 的 ， 页 面 的 行为 、 结 构 和 表现 分 离 。 



































好 的 代码 组 织 结 构 自 然 会 带 来 灵活 性 和 代码 重用 。 在 应 用 的 整个 生命 周期 内 ， 灵 活性 表现 
在 很 多 阶段 ， 不 同 的 代码 可 以 分 开 开 发 〈 暴 露 新 的 API、 创 建 移动 客户 端 、 测 试 和 发 布 应 
用 的 新 版 本 ， 这 些 都 可 以 是 独立 的 )。 有 了 清晰 的 组 件 ， 我 们 才能 更 好 地 重用 代码 。 至 少 ， 
同一 份 RESTful API 可 供 不 同 的 浏览 器 和 移动 设备 使 用 。 
































组 件 化 的 方式 易于 引入 脆弱 的 耦 含 ， 适 配 性 也 不 好 ， 很 难 插 入 不 同 的 前 端 。 


1.5.2 “设计 的 灵活 性 ”与 “使 用 开源 API” 

组 件 化 的 方式 包括 了 高 度 集成 的 服务 器 端 代码 ， 这 些 代码 要 求 了 解 特定 的 JavaScript 技术 。 
从 设计 和 行为 的 角度 看 ， 生 成 的 HTML 和 CSS 限制 了 选择 性 。 一 个 单独 运行 JavaScript 的 
客户 端 能 使 用 最 新 的 类 库 ， 简 化 浏览 器 兼容 性 、 标 准 化 DOM 操作 ， 并 提供 复杂 的 小 组 件 。 





























1.5.3 ”原型 

由 于 分 层 清 晰 ， 为 客户 端 一 服务 器 端的 Web 应 用 搭建 原型 很 方便 。 正 如 前 面 提 到 的 ， 原 
型 可 以 测试 和 验证 初始 想法 ， 帮 助 浴 清 模糊 的 概念 ， 方 便 清晰 地 交流 需求 。 用 户 和 这 种 更 
具体 的 东西 交互 能 产生 新 的 想法 ， 这 远 比 宛 长 的 文字 描述 或 图 片 有 用 得 多 。 原 型 还 能 帮助 
用 户 快速 地 认识 ， 纠 正 错误 的 想法 和 不 一 致 性 。 如 果 正 确 使 用 ， 原 型 能 帮助 节省 时 间 、 金 
钱 和 资源 ， 最 终 产 生 一 个 更 好 的 产品 。 


















































1.5.4 开发 者 的 效率 

除了 可 以 分 别 (或 同时 ) 搭建 客户 端 和 服务 器 端的 原型 ， 工 作 也 能 清晰 地 拆 分 ， 从 而 进行 
并 行 开发 。 这 种 隔离 让 代码 能 分 开 编 写 ， 这 就 避免 了 模块 化 方式 中 页 面 一 更 改 就 得 构建 整 
个 服务 器 端 代码 的 问题 。 开 发 任务 花 的 时 间 和 精力 变 少 ， 更 改 也 没有 原来 复杂 ， 故 障 诊 断 
也 变 得 简单 了 。 

当 需 要 替换 、 升 级 或 重新 分 配 服务 器 端 代码 时 ， 这 点 变 得 尤其 明显 。 这 样 的 改动 可 以 独立 


完成 ， 不 会 影响 客户 端 。 唯 一 的 限制 是 原来 的 接口 (特别 是 URL 和 数据 结构 ) 需要 保持 
可 用 。 



































1.5.5 ”应 用 性 能 

页 面 的 感知 性 能 对 用 户 体验 影响 极 大 。 更 快 的 JavaScript 引擎 让 客户 端 可 执行 计算 密集 型 
操作 ， 从 而 将 服务 器 的 工作 负荷 转移 到 客户 端 。Ajax 技术 能 够 按 需 请 求 较 少 的 数据 ， 这 如 
免 了 对 整个 页 面 的 频繁 刷新 ， 请 求 中 传输 的 数据 也 减少 了 。 用 户 和 应 用 交互 时 ， 反 应 更 及 
时 ， 体 验 更 流畅 。 


无 状态 的 设计 让 开发 者 和 技术 支持 的 工作 更 轻松 。 用 于 管理 会 话 的 资源 可 以 得 到 释放 ， 这 
简化 了 负载 均衡 和 配置 。 服 务 器 很 容易 被 加 进来 以 应 对 增长 的 负荷 ， 方 便 了 水 平 扩展 。 而 
且 ， 这 还 取代 了 传统 的 、 通 过 升级 硬件 提高 否 吐 量 和 性 能 的 流程 ， 那 种 流程 真 让 人 头疼 。 


优点 还 不 止 于 此 ， 它 从 整体 上 简化 了 系统 架构 。 比 如 ， 在 云 环 境 中 维持 状态 是 件 非 常 有 挑 
战 性 的 事 。 如 果 使 用 传统 的 有 状态 会 话 ， 高 效 地 持久 化 数据 是 个 问题 ， 如 何 才能 在 一 个 用 
户 会 话 的 多 个 请 求 中 保持 数据 的 一 致 ”如 果 数 据 存 储 在 后 台 的 一 个 服务 器 中 ， 后 续 被 分 配 
到 其 他 服务 器 的 请 求 就 无 法 访问 该 数据 ， 可 能 的 解决 方案 有 如 下 。 


使 用 支持 集群 和 故障 转移 功能 的 应 用 服务 器 ， 以 Weblogic 为 例 ， 它 使 用 了 托管 服务 器 的 概 
念 。 这 种 解决 方案 需要 额外 的 管理 工作 ， 每 个 应 用 服务 器 的 实现 方式 也 不 同 。 















































i 


时 用 会 话 关联 或 粘 滞 会 话 (sticky session)， 此 时 一 个 用 户 会 话 内 的 所 有 请 求 都 被 发 送 到 同 
一 个 后 端 服务 器 ， 但 是 不 提供 自动 故障 转移 功能 。 


使 用 集中 的 数据 存储 。 通 常 都 是 将 数据 持久 化 到 数据 库 中 ， 这 种 方式 的 性 能 不 好 。 


将 数据 存储 在 客户 端 。 这 避免 了 将 会 话 数据 存储 到 数据 库 的 性 能 问题 ， 也 解决 了 使 用 粘 灌 
会 话 带 来 的 故障 转移 问题 ， 因 为 任何 一 个 后 端 服务 器 都 能 处 理 来 自 客户 端的 请 求 。 


避免 管理 服务 器 端 状态 的 做 法 越 来 越 流 行 ， 其 至 像 JSF 这 样 原来 被 设计 成 传统 的 服务 器 端 
管理 用 户 会 话 的 框架 ， 现 在 也 加 入 了 支持 无 状态 的 功能 。 


创建 客户 端 - 服务 器 端的 应 用 有 一 些 不 可 避免 的 挑战 。 我 们 有 必要 将 JavaScript 看 作 头 等 























8 | 第 1 章 


开发 语言 ， 这 意味 着 需要 深入 学 习 该 语言 、 使 用 现 有 类 库 ， 以 及 借鉴 成 熟 的 开发 技巧 。 原 
来 被 普遍 接受 的 一 些 架构 技术 需要 重新 设计 ， 比 如 管理 会 话 的 标准 实践 。 对 客户 端 - 服务 
器 端的 Web 应 用 并 没有 定义 良好 的 标准 。JEE 的 某 些 部 分 〈 比 如 JAX-RS) 证 清 了 一 些 概 
念 ， 但 其 他 框架 (如 JSF) 并 未 遵循 这 些 定义 。 




















越过 了 初期 学 习 (和 忘记 原 有 知识 ) 曲线 ， 使 用 客户 端 一 服务 器 端的 模式 搭建 Web 应 用 
就 变 得 异常 高 效 和 稳定 。 对 服务 器 端 和 客户 端 职责 的 清晰 划分 ， 让 修改 和 扩展 代码 变 得 更 
容易 。 对 于 Web 本 质 的 清楚 认识 减少 了 模糊 设计 带 来 的 问题 ， 水 平 扩展 的 能 力也 大 大 超出 
了 使 用 其 他 设计 所 能 带 来 的 效果 。 





























1.6 小结 

新 的 挑战 带 来 新 的 机 遇 。 客 户 端 - 服务 器 端的 架构 设计 是 对 Web 和 Web 开发 变化 做 出 的 
理 所 应 当 的 响应 。 它 清楚 什么 没有 改变 ， 因 而 能 够 指导 人 们 开发 出 稳定 、 持 入 的 解决 方 
案 ， 为 后 续 的 增强 打 好 了 基础 。 
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JavaScript 和 JavaScript 工 具 





“JavaScript 是 最 受 轻 视 的 语言 ， 因 为 它 不 是 其 他 语言 。 如 果 你 擅长 其 他 语言 ， 但 
现在 必须 在 只 支持 JavaScript 的 环境 里 工作 ， 那 么 你 必须 使 用 JavaScript， 这 真是 
太 烦 人 了 。 在 这 种 情况 下 ， 大 多 数 人 一 开始 不 悄 于 学 习 JavaScript， 随 后 却 会 惊 
讶 地 发 现 JavaScript 和 他 们 原本 想 要 使 用 的 其 他 语言 差别 如 此 之 大 ,而 且 这 些 差 
别 非常 重要 。” 

一 一 道格拉斯 . 克 罗 克 福 德 


道格拉斯 . 克 罗 克 福 德 (Douglas Crockford) 将 JavaScript 总 结 为 一 门 很 多 人 使 用 却 鲜 有 
人 学 习 的 语言 。 他 写 了 一 本 书 ， 列 举 了 该 语言 的 合理 用 法 和 强大 功能 ， 同 时 指出 了 存在 问 
题 、 需 要 回避 的 部 分 。 如 果 你 需要 经 常 使 用 JavaScript， 应 该 花 时 间 和 精力 全 面 学 习 。 道 
格拉 斯 " 克 罗 克 福 德 忽略 了 该 语言 中 的 很 多 功能 ， 将 精力 集中 在 一 个 强大 、 简 洁 的 子 集 ， 
这 种 方式 能 帮助 程序 员 更 好 地 学 习 JavaScript。 






































除了 学 习 JavaScript 语言 本 身 〈 后 来 被 标准 化 ， 称 为 ECMAScript) ， 还 需要 花 时 间 学 习 特 
定 的 编程 环境 。 其 他 语言 运行 在 操作 系统 、 关 系 型 数据 库 或 宿主 应 用 之 上 ， 而 JavaScript 
最 初 被 设计 成 在 浏览 器 上 运行 。 ECMAScript 语言 规范 (http://www.ecma-international.org/ 
publications/files/ECMA-ST/Ecma-262.pdf) 明确 指明 了 这 点 。 

















ECMAScript 最 初 被 设计 成 一 门 Web 脚本 语言 ， 提 供 了 一 种 让 浏览 器 里 的 页 面 更 
加 生动 的 机 制 ， 并 且 将 基于 Web 的 客户 端 - 服 务 器 端 架 构 中 一 些 服 务 器 端的 计 
算 任 务 交 给 浏览 器 。 


一 一 ECMAScript 语言 规范 





核心 JavaScript 语言 需要 结合 两 个 不 同 的 API 来 理解 : 浏览 器 对 象 模型 (BOM) 和 文档 
对 象 模型 (DOM)。 浏 览 器 对 象 模 型 包含 window 对 象 及 其 子 对 象 : navigator、history、 
screen、Location 和 document。document 对 象 是 文档 对 象 模型 的 根 节 点 ， 是 页 面 内 容 结构 
的 一 个 树 状 表示 。 一 些 对 JavaScript 的 抱怨 其 实 是 针对 浏览 器 对 象 模型 和 文档 对 象 模型 的 
实现 问题 而 言 的 。 不 能 全 面 理解 这 些 API， 就 不 能 有 效 地 在 Web 浏览 器 里 进行 JavaScript 
开发 。 


























本 章 剩余 部 分 介绍 了 在 浏览 器 里 使 用 JavaScript 进行 开发 需要 了 解 的 主要 内 容 。 这 个 介绍 
不 够 全 面 ， 只 是 强调 了 读者 想 要 深入 了 解 这 门 语言 所 需 掌 握 的 入 手 点 和 知识 点 。 














2.1 学 习 JavaScript 


教学 中 广泛 采用 了 Java 作为 编程 语言 ， 和 其 有 关 的 认证 也 已 经 存在 了 很 多 年 ， 因 此 和 Java 
相关 的 知识 已 经 被 充分 理解 、 标 准 化 ， 成 为 通 识 了 。 人 们 经 常 在 学 校 里 就 学 过 Java， 工 作 
后 又 经 过 自学 取得 了 相关 认证 。 同 样 的 情况 并 没有 发 生 在 JavaScript 上 ， 但 还 是 有 一 些 关 
于 JavaScript 的 好 书 可 以 帮助 大 家 学 习 的 。 




















JavaScript: The Good Parts (http://shop.oreilly.com/product/9780596517748.do，O’Reilly 出 
版 )， 道 格拉 斯 克 罗 克 福 德 竺 ， 该 书 在 前 面 已 经 提 到 过 。 在 圈子 里 ， 就 某 些 问 题 对 道 格 
拉 斯 . 克 罗 殉 福 德 提出 异议 已 经 成 为 一 种 时 尚 ， 那 是 因为 他 是 公认 的 权威 ， 他 帮助 很 多 
JavaScript 开发 者 形成 了 自己 的 思想 。 有 时候， 他 提出 一 些 过 于 严格 的 “法 则 ”， 但 是 如 果 
你 不 了 解 JavaScript 语言 的 子 集 (他 认为 属于 “好 的 部 分 ”) 和 他 尽力 避免 使 用 的 部 分 ， 那 
就 是 自 讨 苦 吃 。 














Secrets of the JavaScript Ninia (http://www.amazon.com/Secrets-JavaScript-Ninja-John-Resig/ 
dp/193398869X，Manning Publications 出 版 )，John Resig、Bear Bibeault 著 。John Resig 是 
jQuery 之 父 ， 他 对 现实 中 和 浏览 器 兼容 性 、 操 作 DOM 相关 的 挑战 有 着 深刻 的 理解 。 





还 有 一 些 书 类 似 于 标准 语言 的 参考 手册 ， 包 括 JavaScript: The Definitive Guide (http:// 
shop.oreilly.com/product/9780596805531.do，O’”Reilly 出 版 )、Professional JavaScript for 
Web Development (http://www.amazon.com/Professional-JavaScript-Developers-Nicholas- 
Zakas/dp/1118026691，Wrox Press 出 版 ，Nicholas C. Zakas 著 ) 。 它 们 比 前 面 两 本 书 内 容 
更 全 面 〈 作 者 的 个 人 观点 也 少 )。 它 们 可 能 不 是 那 种 需要 从 头 读 到 尾 的 书 ， 但 是 在 深入 某 
个 具体 的 主题 时 却 是 非常 有 用 的 。 




















本 方 不 打算 重复 你 在 上 述 书 或 其 他 书 中 所 能 学 到 的 全 部 内 容 ， 而 是 帮助 你 上 手 ， 评 估 自 己 
的 JavaScript 知识 。 本 章 还 会 引用 其 他 书籍 和 资源 ， 如 果 你 碰 到 想 要 深入 研究 的 术语 或 概 
念 ， 可 参考 它们 。 





























自觉 阶段 
学 习 过 程 中 的 关键 一 环 是 知道 自己 知道 什么 ， 以 及 知道 自己 能 够 知道 什么 。 达 克 效 
应 (http://en.wikipedia.org/wiki/Dunning%E2%80%93Kruger_effect) 是 一 种 认 知 上 的 偏 
差 ， 它 描述 了 这 样 一 种 倾向 : 低 技能 的 人 错误 地 认为 他 们 的 能 力 高 于 平均 水 平 。 鉴 于 
围绕 JavaScript 的 困 吉 和 其 被 嘲笑 为 一 种 “玩具 语言 ”的 频率 ， 本 节 的 目标 (和 自觉 
阶段 学 习 模型 相关 ; 自觉 阶段 学 习 模 型 参见 http://en.wikipedia.org/wiki/Four_stages_of_ 
competence) 站 在 让 读者 意识 到 要 学 些 什么 。 











2.2 ” ”JavaScript 的 历史 


关于 JavaScript 的 历史 已 有 详尽 的 记录 ，Brendan Eich 在 1995 年 用 10 天 时 间 写 出 了 
JavaScript 的 初 始 版 本 (http:/www.w3.org/community/webed/wiki/A_Short_History_of 
JavaScript) 。 但 如 果 将 JavaScript 放 在 计算 机 科学 的 历史 里 来 考量 ， 尤 其 是 和 现存 第 二 古老 
的 高 级 程序 语言 Lisp 相 联系 ， 应 该 会 更 有 意义 。John McCarthy 在 1958 年 〈( 比 Fortran 晚 
一 年 ) 发 明了 Lisp， 这 是 一 种 计算 机 程序 的 数学 表达 。Scheme 是 Lisp 两 种 主要 的 方言 之 
一 。 奇 怪 的 是 ， 尽 管 和 其 他 语言 的 设计 反差 强烈 ，Scheme 却 在 JavaScript 的 历史 里 扮演 了 
异常 重要 的 角色 。 图 2-1 列 出 了 一 些 影响 了 JavaScript 设计 的 主要 语言 。 
































面向 对 象 编程 
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六 
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2-1: JavaScript 语法 继承 关系 





Scheme 极 简 主义 的 设计 风格 并 没有 体现 在 JavaScript 中 ，JavaScript 相对 宛 长 的 语法 来 自 其 
他 语言 ， 这 点 在 JavaScript 1.1 规范 (http://hepunx.rl.ac.uk/~adye/jsspec11/intro.htm#1006028) 
中 有 所 提 及 : 


JavaScript 的 语法 大 多 来 自 Java， 同 时 继承 了 Awk 和 Perl 的 一 些 语法 ， 其 基于 原 
型 的 对 象 模型 间接 受到 Self 的 影响 。 





JavaScript 1.1 规范 


这 和 Scheme 截然 相反 ，Scheme 的 语法 没有 受 多 种 语言 的 影响 。Perl 直接 影响 了 JavaScript 
的 某 些 部 分 ， 比 如 对 正则 表达 式 的 支持 。 然 而 Perl 的 往 言 : 不 止 一 种 方法 去 做 一 件 
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事 (TMTOWTDI, “there’s more than one way to do 记 ， 参 见 http://en.wikipedia.org/wiki/ 
There’s_more_than_one_way_to_do_it) 可 能 在 更 广 的 范围 上 影响 了 JavaScript。 至 少 可 以 反 
过 来 说 ,“ 只 用 一 种 方式 去 做 一 件 事 ”( 在 Python 社区 里 很 流行 ) 并 不 适用 。 请 看 如 下 创建 
和 初始 化 数组 的 不 同方 式 : 




















var coLors1 = []; 
colors1[0] = "red"; 
colors1i[1] = "orange"; 


var colors2 = ["yellow", "green", "blue"]; 


var colors3 = new Array(2); 
colors3[0] = "indigo"; 
colors3[1] = "violet"; 


var colors4 = new Array(); 
colors4[0] = "black"; 
colors4[1] = "white"; 





因此 ， 看 起 来 JavaScript (及 其 受到 多 种 语言 的 影响 和 语法 上 的 变种 ) 和 Scheme (Lisp 的 
极 简 方言 ) 之 间 似 乎 没有 任何 关联 。 但 是 ，JavaScript 的 确 和 Scheme 关系 紧密 (http:// 
brendaneich.com/tag/history/) ， 直 接受 其 影响 : 














就 像 我 常 说 的 ，Netscape 的 其 他 人 也 可 以 作证 ,我 受 雇 于 Netscape 时 承诺 “在 浏 
览 器 里 使 用 Scheme”。 





Brendan Eich 


这 一 点 也 反映 在 ECMAScript 语言 规范 (http://www.ecma-international.org/publications/files/ 
ECMA-ST/Ecma-262.pdf) 里 : 





ECMAScript 中 的 一 些 技 术 和 其 他 编程 语言 使 用 的 类 似 ， 尤 其 是 Java、Self 和 
Scheme。 
一 一 ECMAScript 语言 规范 











来 自 Scheme 的 影响 也 被 其 他 人 辨认 出 来 了 。 道 格拉 斯 克 罗 克 福 德 根据 Daniel Paul Friedman 
那 本 经 典 书 The Little Schemer (http://mitpress.mit.edu/books/little-schemer，MIT Press 出 版 )， 
写 了 一 篇 文章 “The Little JavaScripter”(http://www.crockford.com/javascript/little.html， 列 举 了 
Scheme 和 JavaScript 的 共同 点 。Lisp 社区 (欧洲 Lisp 研讨 会 ， 参 见 http:/www.european-lisp- 
symposium.org/) 也 将 ECMAScript 描述 为 一 种 “Lisp 方言 ”。JavaScript 和 Scheme 语言 之 间 
的 相似 性 不 可 否认 ， 这 是 由 创造 者 的 本 意 决定 的 。 


2.3 一 门 函 数 式 语 百 
Java 开发 者 倾 问 于 站 在 面向 对 象 的 角度 解决 问题 。 尽 管 JavaScript 也 支持 面向 对 象 ， 但 是 
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条 2 和 章 


这 却 不 是 解决 问题 最 高 效 的 方式 。 使 用 JavaScript 的 函数 式 编程 能 力 会 更 高 效 。 理 解 了 什 
么 是 函数 式 编程 和 它 的 含义 ， 就 弄 清楚 了 这 门 语言 的 本 质 和 能 力 。 














JavaScript 和 Scheme 语言 相像 的 主要 特征 是 它 是 一 门 函 数 式 编程 语言 ， 这 既 和 它 的 起 
源 相 关 ， 也 和 它 的 语法 相关 。 这 里 的 函数 式 编程 语言 是 指 既 支持 函数 式 编程 http:/ 
en.wikipedia.org/wiki/Functional_programming)， 又 支持 将 函数 当 作 一 级 对 象 (http:// 
en.wikipedia.org/wiki/First-class_function) 。JavaScript 的 这 一 基本 概念 为 语言 的 其 他 方面 提 
供 了 方向 。 对 很 多 程序 员 ， 尤 其 是 那些 以 类 似 Java 这 样 还 未 直接 支持 国 数 式 编程 的 语言 为 
基础 的 程序 员 来 说 ， 使 用 函数 式 编程 是 非常 大 的 范式 迁移 。 























2.3.1 作用 域 

作用 域 是 指 程序 中 变量 可 见 和 可 操作 的 范围 ， 在 JavaScript 中 这 个 概念 让 人 很 难 捉摸 。 像 
很 多 其 他 语言 一 样 ， 函 数 可 用 来 包括 一 组 语句 。 这 样 就 能 复 用 函数 ， 同 时 将 信息 可 见 性 限 
制 在 一 个 易 理解 的 模块 化 单元 中 。ECMAScript 语言 规范 (http://www.ecma-international. 
org/publications/files/ECMA-ST/Ecma-262.pdf) 定义 了 三 个 执行 上 下 文 : 全 局 、eval 和 国 
数 。 和 其 他 类 C 语言 不 同 ，JavaScript 没有 区 块 级 作用 域 ,但 是 有 函数 级 作用 域 。 像 if 语 
句 这 样 的 区 块 结构 不 会 产生 新 的 作用 域 。 















































使 用 JavaScript 的 危险 之 一 是 方法 或 变量 被 提升 到 作用 域 顶 端 ， 它 们 是 在 那里 定义 的 。 函 
数 声明 在 作用 域 执行 时 就 已 经 存在 了 ， 所 以 函数 被 提升 到 执行 上 下 文 的 顶端 。 按 照 经 验 ， 
可 在 作用 域 顶端 使 用 var 声明 所 有 要 在 作用 域 里 用 到 的 变量 来 避免 这 类 问题 : 














// 这 不 是 Java 中 的 成 员 变 量 …… 
var Xx = 'set'; 


var y = function () { 
// 你 可 能 想不到 -> var x; 被 提升 到 这 一 行 ! 


if(!x) { // 你 可 能 觉得 该 变量 此 时 已 经 被 初始 化 
// 但 是 却 没 有 ,因此 会 执行 该 段 代码 








var x = 'hoisted'; 
} 
alert(x); 
} 
//…… 这 条 语句 会 弹出 警告, 显示 "hoisted" 
yO); 




















注 1: 函数 式 编程 在 JVM 上 已 经 存在 一 段 时 间 了 ， 使 用 过 一 些 基于 JVM 的 脚本 语言 ， 包 括 Rhino JavaScript 
实现 。Java 8 计划 加 入 Lambda 表达 式 、 闭 包 和 相关 语言 特性 。Java 8 还 会 加 入 一 个 新 的 JavaScript 实 
现 : Nashorn。 随 着 不 断 加 入 新 功能 ， 未 来 几 年 ，JavaScript 开发 ， 尤 其 是 函数 式 编程 将 变 成 Java 开 
发 者 需要 深入 学 习 的 内 容 。 
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这 个 例子 还 包含 了 一 些 在 Java 中 见 不 到 的 特性 。 

















。 在 JavaScript 中 ，null、undefined 和 其 他 一 些 值 被 当 作 false。 

。 if 语句 中 的 条 件 判 断 表达 式 是 !x, 感 叹 号 代表 逻辑 非 操 作 , 因 此 ,如 果 x 是 undefined (或 
者 nutl)， 则 if (1x) 为 true。 如 果 x 是 一 个 数字 或 字符 串 ， 则 会 像 使 用 过 其 他 语言 的 

开发 者 期 望 的 那样 ， 值 为 false。 

。 使 用 var 关键 字 定义 局 部 变量 ， 没 有 使 用 该 关键 字 定 义 的 变量 为 全 局 变量 。 使 用 var 关 
键 字 定 义 的 局 部 变量 的 作用 域 和 函数 的 作用 域 相关 。 

。 创建 一 个 函数 后 将 其 赋值 给 变量 y， 这 对 Java 程序 员 来 说 有 些 奇 怪 ， 因 为 在 他 们 的 世界 
里 ， 方 法 只 和 类 或 对 象 的 实例 关联 。 该 语法 展现 了 JavaScript 国 数 式 语 言 的 本 质 。 
























































2.3.2 一 级 函数 

从 任何 严格 的 意义 上 来 说 ， 拥 有 限定 作用 域 的 函数 并 不 能 归 为 函数 式 语言 。 函 数 式 语言 
是 指 支 持 一 级 函数 的 语言 。 根 据 Structure and Interpretation of Computer Programs (http:// 
mitpress.mit.edu/sicp/full-text/book/book-Z-H-12.html#%_idx_1218) 这 本 书 的 描述 ， 一 级 函 
数 可 以 赋 给 一 个 变量 ， 作 为 参数 传递 给 另外 一 个 函数 ， 作 为 函数 的 返回 值 ， 或 者 包含 在 其 
他 数据 结构 中 。 下 面 的 例子 (为 说 明 问 题 人 为 设计 的 ) 展示 了 这 些 功 能 ， 还 有 一 些 专家 认 
为 函数 式 编程 语言 必须 具备 一 个 特性 ， 支持 匿名 函数 。 







































































1/ 
// 可 在 任何 一 款 现代 浏览 器 的 Javascript 控 制 台 里 执行 下 面 的 程序 
// 





// 将 函数 赋 给 变量 
var happy = function(){ 
return ':)'; 


} 


var sad = function(){ 
return ':('; 


} 
// 该 函数 接收 一 个 函数 (作为 参数 ) ,又 返回 一 个 函数 


var mood = function(aFunction){ 
return aFunction 














} 


// 将 函数 加 入 一 种 数据 结构 , 即 数组 中 
list = [happy, sad] 


//…… 加 入 JavaScript 对 象 


response = {fine: happy, underTheWeather: sad} 


// 传 入 一 个 函数 ,调用 后 返回 另 一 个 函数 ,并 将 该 函数 赋 给 一 个 变量 
var iAmFeeling = mood(happy); 
console.log(iAmFeeling()); 











大 
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// 再 来 一 次 
var iAmFeeling = mood(sad); 
console.log(iAmFeeling()); 











// 函数 可 以 被 包含 在 一 个 数据 结构 里 
// 这 里 的 数据 结构 是 一 个 JavaScript 对 象 








console.log(response.fine()); 


// 或 者 你 想 使 用 数组 这 种 数据 结构 …… 
console.log(list[0]()); 


// 最 后 ,直接 定义 和 使 用 一 个 匿名 函数 
console.log(function(){ 
return ";)"; 





}0); 


从 这 个 例子 中 可 以 清楚 地 看 到 ， 函 数 是 JavaScript 中 的 基本 单元 ， 是 名 副 其 实 的 一 级 对 
象 。 它 可 以 脱离 对 象 和 其 他 结构 单独 存在 ， 也 可 以 出 现在 任何 表达 式 可 以 出 现 的 地 方 。 和 
JavaScript 中 其 他 对 象 的 区 别 是 : 函数 可 以 被 调用 。 由 于 函数 是 一 级 对 象 ， 而 且 是 主要 的 
可 执行 单元 ， 使 用 函数 可 以 写 出 短小 精 悍 的 代码 。 和 函数 相关 的 作用 域 产生 了 一 些 习 惯用 
法 ， 很 多 JavaScript 新 手 对 此 并 不 熟悉 。 












































JavaScript 真 的 是 函数 式 的 吗 ? 
有 些 人 质疑 JavaScript 是 否 能 称 得 上 是 一 门 函 数 式 编程 语言 。 上 毕竟， 函数 式 编程 是 在 
模仿 没有 副作用 的 数学 函数 。 而 任何 使 用 过 JavaScript 的 人 ， 都 见识 过 其 臭名 昭著 的 
全 局 上 下 文 ， 而 且 操 作 DOM 时 ， 几 乎 百分之百 会 用 到 充满 副作用 的 函数 。 引 用 透明 
性 就 无 从 谈 起 了 。 而 有 全， 很 多 JavaScript 程序 都 知 芒 周围 环境 ， 变 量 是 可 变 的 。 纯 函 
数 式 编程 语言 使 用 不 可 变 变量 〈 这 带 来 了 很 多 好 处 ， 比 如 方便 实现 并 发 操作 ) 。 
JavaScript 有 对 象 和 基于 原型 的 继承 ， 因 此 也 可 以 说 它 是 面向 对 象 的 ， 至 少 它 是 一 种 支 
持 多 范 型 的 编程 语言 。 
JavaScript 包含 函数 ， 支 持 将 函数 作为 一 级 对 象 ， 这 是 无 可 争辩 的 事实 。 读 者 可 自行 
选择 “有 孙 数 式 编程 语言 ”的 定义 (因为 并 不 存在 一 个 权威 的 定义 )， 对 JavaScript 是 否 
属于 函数 式 编程 语言 做 出 自己 的 判断 。 本 书 使 用 肠 数 式 编程 是 因为 其 突出 了 JavaScript 
中 优质 的 功能 。 读 者 如 需 从 这 方面 更 加 深入 了 解 JavaScript， 可 参考 Michael Fogus 所 
著 的 Functional JavaScript (http://shop.oreilly.com/product/0636920028857.do，O’Reilly 
出 版 ) 一 书 ， 该 书 介 绍 了 很 多 使 用 JavaScript 的 函数 式 编程 技巧 ， 其 中 很 多 都 使 用 了 
underscore.js 类 库 (http:/underscorejs.org/) 。 











2.3.3 函数 声明 和 表达 式 
JavaScript 中 的 字面 函数 由 以 下 四 部 分 组 成 : 
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。 function 操作 符 ， 
。 可 省 略 的 函数 名 ， 
。 一 对 小 括号 (包含 零 到 多 个 参数 ) ， 
。 一 对 大 括号 (包含 零 到 多 条 语句 ) 。 





在 JavaScript 中 ， 一 个 合法 的 最 小 化 函数 声明 如 下 所 示 ， 
function(){} 

函数 可 以 有 函数 名 ， 这 和 传统 的 类 C 语言 的 语法 风格 比较 像 : 
function myFunctionName(){} 


没有 名 字 的 函数 称 为 匿名 函数 。 匿 名 汐 数 可 以 在 一 个 表达 式 中 使 用 ， 可 以 被 赋 给 一 个 变 
量 。 有 些 人 喜欢 这 样 的 语法 ， 因 为 它 能 让 人 清楚 地 意识 到 变量 保存 的 是 一 个 函数 值 : 











var x = function () {} 
具名 函数 也 可 以 赋 给 一 个 变量 : 
var x = function y() {} 


这 种 使 用 方式 ， 让 函数 外 部 得 以 用 变量 x 引用 函数 ， 函 数 内 部 也 可 以 通过 函数 名 y 引用 该 
0 


函数 可 以 关联 至 一 个 对 象 ， 这 时 称 之 为 方法 。 对 象 被 隐 式 传递 给 其 所 调用 的 方法 ， 方 法 可 
以 访问 和 操作 对 象 里 的 数据 ， 通 过 this 关键 字 引 用 对 象 ， 如 下 所 示 : 


var obj = 位; // 创建 一 个 新 的 JavaScript 对 象 

obj.myVar = 'data associated with an object' 

obj.myFunc= function(){return 'I can access ' + this.myVar;} // this: 引用 该 对 象 
consoLe.Log(obj.myFunc()) 


























可 以 在 函数 中 定义 其 他 函数 ， ge 一 个 函数 返回 一 个 内 
部 函数 时 ， 就 形成 了 闭 色 。 返 回 的 对 象 既 包 含 了 函数 本 身 ， 也 包含 创建 函数 时 的 环境 : 











function outer() { 
var vaL = "I am in outer space"; 
function inner() { 
return val; 
} 
return inner; 


} 


var alien = outer(); 
console.log(alien()); 


立即 执行 函数 (immediate function) 将 代码 限定 在 函数 的 局 部 作用 域内 ， 避 免 了 污染 全 局 





作用 域 : 


(function() {console.log('in an immediate function')}()); 


2.3.4 ”函数 调用 
有 四 种 方式 调用 函数 : 


. 函数 ， 

。 方法 ; 

。 构造 国 数 ， 

。 使 用 caLL() 或 appLy()。 


不 同 的 方式 会 影响 this 关键 字 引 用 的 对 象 。 第 一 种 方式 〈 国 数 )， 在 非 严 格 模式 下 ，this 
指 全 局 上 下 文 ; 在 严格 模式 下 , 返回 undefined 或 者 在 执行 上 下 文中 得 到 的 值 。 接 下 来 的 两 
种 方式 (方法 和 构造 函数 ) 是 面向 对 象 编程 所 特有 的 ， 其 中 方法 调用 是 调用 和 对 象 关联 的 
函数 ， 而 调用 构造 函数 会 创建 一 个 新 对 象 。 和 以 上 三 种 方式 不 同 ，call() 和 appty() 允许 
在 调用 一 个 函数 时 ， 显 式 指 定 上 下 文 。 




















this 和 that 
JavaScript 中 有 个 惯例 ， 乍 看 之 下 让 人 莫名 其 妙 : 

var that = this 
在 理解 了 JavaScript 中 的 this 是 如 何 工作 的 之 后 ， 这 种 用 法 就 一 目 了 然 了 。 
this 随 上 下 文 〈 作 用 域 ) 而 变 ， 所 以 一 些 开 发 者 将 它 赋 给 that， 以 访问 
this 原来 所 指 的 值 。 




















2.3.5 ”函数 参数 

前 面 提 到 过 ， 函 数 通过 签名 中 声明 的 命名 参数 接收 参数 。 有 一 个 特殊 的 变量 arguments， 
它 保存 了 所 有 传 入 函数 的 参数 ， 不 管 是 有 名 的 还 是 没 名 的 。 下 面 的 例子 展示 了 如 何 分 别 使 
用 标准 的 函数 调用 、caLL() 和 apply() 将 三 个 数字 相 加 : 














function add(){ 
Var Sum=0; 
for (i=0; i< arguments.Length; i++){ 
sum+=arguments[i]; 
} 


return sum; 


console.log(add(1,2,3)); 
console.log(add.apply(null, [2,3,4])); 
console.log(add.call(null,3,4,5)); 
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2.3.6 ”对 和 象 


在 Java 中 ， 对 象 是 所 定义 的 类 的 实例 。 在 JavaScript 中 ， 对 象 只 是 一 组 属性 的 集合 。 
JavaScript 中 的 对 象 也 有 继承 (从 它 的 原型 那里 )， 面 向 对 象 的 设计 原则 对 它 也 是 适用 的 ， 
但 是 它 和 Java 中 的 方式 大 相 径 庭 。 可 以 在 JavaScript 中 创建 类 (http://www.phpied.com/3- 
ways-to-define-a-javascript-class/) ， 但 是 以 Java 中 的 方式 去 思考 它 是 行 不 通 的 (Java 中 的 类 
是 基本 的 、 必 需 的 ) 。 








基于 类 和 基于 原型 的 继承 让 JavaScript 和 Java 如 此 不 同 ， 这 也 导致 了 很 多 疑惑 。JavaScript 
中 的 其 他 特性 也 可 以 和 Java 对 照 着 来 看 。 


2.4 面向 Java 开 发 者 的 JavaScript 

如 果 仅 从 表面 上 看 ， 大 多 数 开 发 者 认为 JavaScript 只 不 过 组 装 了 Java 或 其 他 类 C 语言 的 语 
法 for 循环 、 条 件 语句 等 )， 但 是 如 果 看 一 个 完整 的 Java 程序 ， 差 别 马上 就 出 来 了 。 下 
看 是 一 个 经 典 的 Java 程序 ， 展 现 了 和 JavaScript 代码 以 及 开发 方式 上 的 不 同 。 



































2.4.1 HelloWord.java 


/** 
* HelloWorld 
*] 
class HelloWorld{ 


public static void main (String args[]){ 
System.out.println("Hello World!"); 
} 
} 


想 要 在 命令 行 里 看 到 这 个 久负盛名 的 Hello World 程序 的 输出 ， 你 必须 : 








(1) 创建 一 个 名 为 HelloWorld.java 的 源 文件 ; 
(2) 将 Java 代码 编译 为 类 文件 (在 命令 行 里 使 用 javac 编译 器 ) ; 
(3) 执行 类 文件 (在 命令 行 里 使 用 java 解释 器 ) 。 








如 果 你 使 用 像 Eclipse 或 Intellij 这 样 的 集成 开发 环境 ， 这 些 步骤 都 有 对 应 的 菜单 项 。 很 简 
单 ， 执 行 该 程序 ， 输 出 “Hello World!”。 但 是 这 个 简单 的 例子 却说 明了 Java 和 JavaScript 
的 诸多 不 同 之 处 。 


下 

















下 是 对 应 的 JavaScript 程序 ， 输 出 结果 是 一 样 的 : 








consoLe.Log('HeLtLo World') 





1. 程序 执行 


首先 ，JavaScript 是 一 门 解释 性 语言 ， 不 需要 编译 。 该 在 什么 环境 里 执行 JavaScript 代码 


呢 ? 如 果 你 安装 了 node (http://nodejs.org/)， 可 在 node 的 命令 行 里 执行 : 
> console.log("Hello World") 


Hello World 


也 可 以 在 浏览 器 控制 台 里 执行 。 在 Chrome 中 ， 选 择 视 图 一 开发 者 一 JavaScript 控制 台 (如 
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> console.log('Hello World!') 
Hello World! 
undefined 
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图 2-2: Chrome JavaScript 控制 台 


在 Firefox 中 ， 选 择 工 具 一 Web 开发 者 一 Web 控制 台 (如 图 2-3 所 示 )。 
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2-3: Firefox JavaScript 控制 台 





其 他 一 些 现代 浏览 器 也 提供 了 类 似 的 功能 。 





宿主 对 象 
从 技术 的 角度 讲 ，JavaScript 本 身 没有 内 置 输入 /输出 功能 (由 运行 时 环境 提供 ， 这 
里 是 由 浏览 器 提供 )。 根 据 ECMA 标准 (http://www.ecma-international.org/ecma- 
262/5.1/#sec-4) : 


ECMAScript 并 未 被 定义 成 一 门 计算 完备 的 语言 。 事 实 上 ， 本 标准 未 定义 如 
何 输入 外 部 数据 ， 也 未 定义 如 何 将 计算 结果 输出 。 相 反 ，ECMAScript 程序 
的 运行 环境 不 仅 负责 提供 本 标准 描述 的 对 象 和 结构 ， 也 负责 提供 和 环境 相关 
的 宿主 对 象 。 对 它们 的 描述 超出 了 本 标准 的 范围 ， 本 标准 只 略微 提 及 它们 的 
一 些 属 性 和 方法 ， 这 些 属 性 和 方法 可 以 在 ECMAScript 程序 中 访问 或 调用 。 





标准 中 未 定义 这 些 不 仅 是 因为 好 奇 ， 微 软 的 正 浏 览 器 有 好 几 个 版 本 都 没有 console. 
log， 常 常会 引发 一 些 不 可 预料 的 错误 。 很 多 和 JavaScript 相关 的 挑战 和 问题 ， 其 责 
任 都 在 运行 环境 (通常 是 浏览 器 )。DOM 是 一 个 跨 平台 、 和 语言 无 关 的 引用 及 操作 
HTML 元 素 的 方法 ， 它 本 身 并 不 是 JavaScript 语言 的 一 部 分 。 
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让 我 们 再 回 到 那个 Hello World 程序 。 你 可 能 已 经 注意 到 ， 我 们 使 用 了 单 引 号 ， 而 不 古 双 
引号 ， 也 没有 以 分 号 结尾 。JavaScript 的 语法 更 宽容 (或 者 说 更 含混 )。 有 很 多 发 明 来 减 
少 因 此 造成 的 困惑 。 语 言 本 身 添加 了 严格 模式 (https://developer.mozilla.org/en-US/docs/ 
Web/JavaScript/Reference/Functions_and_function_scope/Strict_mode)。 由 道格拉斯 . 克 罗 
克 福 德 开 发 的 JSLint (http://www.jslint.com/) 等 工具 强迫 程序 员 使 用 JavaScript 语言 

“好 的 部 分 ”， 你 可 参考 他 写 的 书 (http://www.amazon.com/exec/obidos/ASIN/0596517742/ 
wrrrldwideweb) 深入 了 解 这 方面 内 容 。 可 以 这 样 说 ，JavaScript 有 很 多 陷阱 ， 不 守 纪 律 的 
开发 者 或 团队 使 用 它 会 产生 一 些 难 于 调试 的 问题 。 花 些 时 间 ， 好 好 学 习 该 门 语言 以 养 成 一 
些 习 惯 和 实践 来 避免 这 些 问题 ， 是 很 值得 做 的 一 件 事 


2. 文件 系统 组 织 

Java 项 目的 文件 和 目录 结构 与 代码 的 结构 是 直接 相关 的 。 一 个 源 文件 通常 包含 一 个 ( 公 
有 ) 类 ， 类 名 和 文件 名 相同 。 文 件 的 目录 结构 反映 了 类 的 包 名 〈 对 于 内 部 类 、 访 问 修饰 各 
和 其 他 一 些 结构 会 有 例外 ， 但 是 在 Java 项 目 里 ， 文 件 和 目录 结构 通常 都 遵循 类 似 的 结构 ) 。 
有 时 候 ， 这 些 限制 会 带 来 不 便 〈 特 别 是 对 于 小 型 项 目 )。 随 着 项 目的 成 长 ， 这 种 方式 清晰 
地 表明 了 代码 的 组 织 结构 。 不 用 打开 文件 ， 只 需 曾 一 眼目 录 结 构 就 能 立即 知晓 一 个 项 目 是 
否 组 织 混乱 。 


JavaScript 则 没有 这 种 限制 ， 文 件 或 目录 结构 没有 必然 的 联系 。 因 此 ， 随 着 项 目的 成 
长 ， 你 要 特别 注意 代码 的 组 织 方 式 ， 如 果 是 一 个 大 型 开发 团队 ， 甚 至 要 花 时 间 来 重 构 
代码 的 组 织 结 构 。Alex MacCaw 在 JavaScript Web Applications (http://shop.oreilly.com/ 
product/0636920018421.4o，O’Reilly 出 版 ) 一 书 中 很 好 地 解释 了 这 些 : 
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开发 大 型 JavaScript 应 用 的 秘诀 是 不 要 开发 大 型 JavaScript 应 用 。 你 应 该 将 应 用 
分 解 成 一 些 彼此 独立 的 模块 。 开 发 者 在 开发 应 用 时 常 犯 的 错误 之 一 是 引入 了 太 多 
的 互相 依赖 ， 大 量 的 JavaScript 代码 生成 大 量 的 HTML 标签 。 这 样 的 应 用 难以 维 
护 和 扩展 ， 必 须 想 方 设法 避免 。 

一 一 Alex MacCaw 





关于 代码 组 织 ， 还 有 其 他 一 些 方面 需要 考虑 。 除 了 命名 文件 和 将 代码 保存 在 合适 的 文件 
里 ， 文 件 之 间 的 依赖 需要 依次 加 载 。 当 JavaScript 代码 被 放 到 Web 服务 器 上 ， 按 需 加 载 
可 以 提升 效率 (等 待 所 有 文件 都 下 载 完 成 会 让 浏览 器 伪 死 )。 可 使 用 由 RequireJS (http:// 
requirejs.org/docs/whyamd.html) 等 类 库 支持 的 AMD (Asynchronous Module Definition， 异 
步 模块 定义 ) API (https://github.com/amdjs/amdjs-api/wiki1/AMD) 来 提升 性 能 。 该 API 按 
模块 定义 JavaScript 代码 ， 让 模块 和 其 依赖 能 异步 加 载 。 




















2.4.2” 带 变量 的 HelloWord.java 
演示 Hello World 程序 的 下 一 步 通常 是 用 它 跟 一 个 变量 代表 的 名 字 “ 打 声 招呼 ”: 
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/** 

* HelloWorld2 

*/ 

class HelloWorld2 { 


public static void main (String args[]) { 
String name; 
System.out.println("Hello 


+ Name); 


} 


上 述 代码 不 能 编译 : 





HeLLowWorLd2.java:5: variable name might not have been initialized 


var name ; 
console.log('Hello 


+ Name); 


上 述 JavaScript 程序 可 以 运行 ,但 它 却 是 让 人 产生 困惑 的 源头 之 一 : 太 多 的 值 被 当成 
false。 求 值 的 过 程 充满 内 惑 ， 难 于 记忆 : 


// 结果 都 是 false 























console.log(false ? 'true' : 'false'); 
consoLe.Log(0 ? 'true' : 'false'); 
console.log(NaN ? 'true' : 'false'); 
console.log("! ? 'true' : 'false'); 
console.log(null ? 'true' : 'false'); 
console.log(undefined ? 'true' : 'false'); 
下 面 这 些 结果 是 true: 

// 结果 都 是 true 

ConsoLe.Log('0' ? 'true' : 'false'); 
ConsoLe.Log( 'faLse' ? 'true' : 'false'); 
consoLe.Log([] ? 'true' : 'false'); 
console.log({} ? 'true' : 'false'); 


在 Java 中 初始 化 变量 后 ， 程 序 就 可 以 编译 并 执行 了 : 





/** 

* HelloWorld2 

*/ 

class HelloWorld2{ 


public static void main (String args[]){ 


String name = "Java'"; 
System.out.println("Hello " + name); 
} 


} 
同样 ， 如 果 给 JavaScript 中 的 变量 一 个 初始 值 ， 输 出 会 如 我 们 期 待 的 那样 ， 





























var Name='JavaScript'; 
console.log('Hello ' + name) 














如 果 在 全 局 作用 域 ， 关键 字 var 并 不 是 必需 的 ， 去 掉 它 程序 行为 没有 任何 不 同 。 如 果 是 在 
一 个 函数 里 调用 ，var 会 创建 一 个 局 部 变量 。 一 般 来 说 ， 应 该 在 函数 里 使 用 关键 字 var 声 
明 变 量 ， 防 止 污染 全 局 命名 空间 。 














在 Java 的 例子 中 ， 声 明 变量 需要 指定 类 型 。JavaScript 是 一 种 弱 类 型 的 语言 ， 不 需要 这 样 
做 。typeof 操作 符 可 以 显示 大 多 数 常用 类 型 信息 ， 如 表 2-1 所 示 。 











表 2-1: JavaScript 中 typeof 操 作 符 的 例子 





类 型 结果 例子 

Undefined “undefined” typeof undefined 
Null “object” typeof null 

Boolean “boolean” typeof true 

Number “number” typeof 123 

String “string” typeof "hello" 
Function object “function” typeof function(){} 


所 re % 
2.5 最 佳 开 发 实践 
JavaScript 有 其 自身 的 挑战 和 特性 ， 需 要 特别 的 开发 流程 。 尽 管 我 们 可 以 死 搬 硬 套 熟悉 的 
Java 开发 流程 ， 但 使 用 适合 JavaScript 的 工具 和 流程 会 更 好 。 





2.5.1 编码 规范 和 约定 

本 书 的 大 部 分 内 容 都 关乎 如 何 做 到 客户 端 和 服务 器 端的 松 耦 合 。 不 可 见 JavaScript 是 使 客 
户 端 UI 层 实现 松 耦 合 的 一 组 最 佳 实践 : 

。 使 用 HTML 定义 页 面 数 据 结构 ; 

。 使 用 CSS 为 数据 结构 增加 样式 ; 

。 使 用 JavaScript 为 页 面 增加 交互 功能 。 














也 可 以 这 样 说 : 





。 避免 在 CSS 中 使 用 JavaScript; 
。 避免 在 JavaScript 中 使 用 CSS， 
。 避免 在 HTML 中 使 用 JavaScript; 
。 避免 在 JavaScript 中 使 用 HTML。 
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2.5.2 ”浏览 

浏览 器 无 处 不 在 ， 以 致 于 很 多 Web 用 户 都 不 清楚 它 和 底层 操作 系统 的 区 别 。 浏 览 器 不 仅 是 
终端 用 户 浏览 网 页 的 环境 ， 它 还 是 个 IDE。 浏 览 器 集成 了 调试 器 、 代 码 格式 化 工具 、 分 析 
工具 和 许多 其 他 工具 (有 些 以 插件 和 扩展 的 形式 存在 )， 在 开发 过 程 中 会 用 到 它们 。 

















很 长 一 段 时 间 内 ，Firefox 和 Firebug (https://getfirebug.com/) 等 开发 插件 和 扩展 是 开发 中 
流行 的 浏览 器 ，Chrome 也 自 带 了 一 些 开发 者 工具 ， 大 有 后 来 者 居 上 之 势 。 





Chrome 小 贴 士 

花 点 时 间 研 究 浏 览 器 提供 的 开发 者 工具 和 影响 浏览 器 行为 的 命令 行 选项 是 值得 的 。 为 
了 开发 者 访问 方便 和 提高 生产 效率 ， 经 常会 越过 一 些 安全 限制 或 牺牲 一 点 性 能 ， 比 如 
在 Chrome 中 : 
。 浏览 器 有 清除 缓存 (https://groups.google.com/forum/#%21msg/angular/wMRtJZ7R480/ 

5bFH_ZhgdRwJ) 等 选项 ， 可 以 防止 更 改 代码 时 引起 的 困惑 ; 
。 根据 操作 系统 和 浏览 器 版 本 的 不 同 ， 命令 行 语法 也 略 有 差异 ， 比 如 通过 以 下 命令 可 

以 在 OSX 上 运行 Chrome: 

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome 

在 命令 行 里 加 入 一 些 标签 可 改变 浏览 器 行为 。 如 果 你 的 文件 使 用 Ajax (比如 使 用 
AngularJS) ,--allow-fileaccess-from-files 标签 可 以 让 你 脱离 Web 服务 器 开发 。 如 果 
你 需要 使 用 JSONP 引用 本 机 (localhost) ， 则 必须 使 用 --disabLe-web-security 选项 。 
在 Chrome 中 ， 还 有 一 些 隐 藏 功能 。 在 地 址 栏 里 键入 chrome://chrome-urLs/， 会 列 出 


所 有 可 用 的 通 往 其 他 配置 或 管理 界面 的 URL。 为 了 小 试 牛刀 ,键入 chrome://fLags/ 来 
列 出 当前 版 本 的 浏览 器 所 提供 的 实验 性 功能 吧 。 











浏览 器 作为 JavaScript 的 开发 环境 的 另 一 个 例子 是 许多 JavaScript 开发 在 线 合作 网 站 的 出 
现 ， 比 如 JSFiddle (http://jsfiddle.net/) 和 jsbin (http:Wjsbin.com/) 。 可 以 在 这 些 网 站 上 创建 
示例 应 用 以 重 现 缺 陷 、 和 其 他 人 以 精确 的 方式 交流 语言 中 的 某 些 特定 问题 。 疫 有 理由 使 用 
脱离 上 下 文 的 JavaScript 代码 片段 。 在 线 上 提问 或 演示 某 项 技术 时 ， 提 供 一 个 具体 的 例子 
或 者 实现 一 个 小 型 的 演示 程序 是 很 正常 的 。 














2.5.3 ”集成 开发 环境 

WebStorm (http:/www.bit.ly/jb-webstorm) 是 一 款 非常 优秀 的 IDE， 它 又 轻 又 快 ， 包 括 了 
调试 器 、 一 个 很 棒 的 项 目 视图 、 强 大 的 快捷 键 、 通 过 使 用 插件 的 扩展 方式 和 一 些 其 他 功 
能 。 虽然 不 是 必需 的 ， 但 WebStorm 通过 使 用 向 导 、 快 捷 键 和 代码 补 全 功能 ， 将 很 多 最 佳 
实践 付 诸 其 中 。 

















大 所 
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2.5.4 单元 测试 

有 很 多 为 JavaScript 开 发 的 单元 测试 框架 (http://www.bit.ly/lgvnROC)。 书 中 用 到 的 
Jasmine (http://pivotal.github.io/jasmine/) 是 一 个 行为 驱动 开发 (BDD, http://www.bit. 
ly/1dkUNKU) 的 框架 ， 它 语法 简单 ， 而 且 没 有 外 部 依赖 。 


























Java 的 单元 测试 能 在 每 次 构建 项 目 时 通过 构建 工具 或 脚本 运行 。JavaScript 的 单元 测试 
可 使 用 一 个 Nodejs 的 模块 ，Karma (https://github.com/karma-runner/Kkarma， 原 来 叫 作 
Testacular) 在 多 浏览 器 里 执行 ， 并 且 每 当 修改 并 保存 源 文 件 后 ， 就 会 自动 执行 。 这 一 点 很 
重要 。 如 果 你 能 自律 编写 单元 测试 ， 每 当 文件 保存 时 就 执行 单元 测试 这 一 能 力 将 能 够 在 早 
期 发 现 缺陷 。 这 点 对 JavaScript 来 说 尤其 有 用 ， 因 为 JavaScript 没有 编译 器 ， 不 能 在 早期 验 
证 代码 的 合法 性 。 有 效 的 单元 测试 常常 扮演 一 个 伪 编 译 器 的 角色 ， 它 们 能 够 立刻 反馈 代码 
的 质量 ， 并 且 一 有 缺陷 ， 就 能 检测 到 。 





















































2.5.5 文档 

JavaScript 中 有 很 多 自动 化 文档 生成 工具 。JSDoc (https://github.com/jsdoc3/jsdoc) 有 着 和 
Javadoc 类 似 的 标记 和 输出 ，Dox (https://github.com/visionmedia/dox) 是 一 个 生成 文档 的 
Node.js 模块 。 





文学 编程 (http://en.wikipedia.org/wiki/Literate_programming， 由 高 德 纳 在 20 世纪 70 年 
代 提 出 ) 让 程序 员 用 他 们 自己 思考 的 逻辑 和 流程 顺序 开发 程序 。Docco (http://jashkenas. 
github.io/docco/) 是 一 个 Node.js 模块 ， 它 将 代码 和 注释 组 织 成 一 种 类 似 文章 的 格式 。 虽 然 
Docco 不 直接 验证 和 执行 代码 规范 ， 使 用 它 却 能 鼓励 大 家 使 用 良好 的 代码 结构 和 注释 ， 而 
不 是 不 假 思 索 地 复制 粘贴 。 


2.6 ”项目 


这 是 一 个 小 型 的 展示 对 象 继承 关系 的 JavaScript 项 目 ， 包 含 了 单元 测试 和 文档 。 所 有 文件 
均 能 通过 访问 GitHub (https://github.com/java-javascript/client-server-web-apps/tree/master/ 
Chapter-2-JavaScript-And-Tools/Animals) 获得 。 














Animal.js 是 所 有 对 象 的 根 对 象 


// Animal 处 于 对 象 继承 关系 的 顶部 
function Animal() {} 


// 定义 speak 方 法 , 子 类 中 有 该 方法 的 不 同 实现 
Animal.prototype.speak = function() { 
return "Animal is speaking."; 





}; 
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它 有 两 个 子 类 ， 一 个 是 Cat .js: 


// 定义 Cat 类 
function Cat() { 
Animal.call(this); 


} 


// 设置 对 象 的 原型 
Cat.prototype = new Animal(); 


// 使 用 类 名 为 构造 函数 命名 


Cat.prototype.constructor = Cat; 


// 实现 具体 的 函数 
Cat.prototype.speak = function(){ 
return "meow"; 


} 
一 个 是 Dog.js: 
// 定义 Dog 类 


function Dog() { 
Animal.call(this); // 调用 父 对 象 的 构造 函数 

















} 


// Dog 继 承 自 Animal 
Dog.prototype = new Animal(); 


// 更 新 构造 函数 以 和 新 类 匹配 


Dog.prototype.constructor = Dog; 











// 替换 speak 方 法 
Dog.prototype.speak = function(){ 
return "woof"; 


} 


最 新 版 本 的 Jasmine 可 在 GitHub (https:// github.com/pivotal/jasmine) 上 获得 : 





curl -L \ 
https://github.com/downloads/pivotal/jasmine/jasmine-standalone-1.3.1.zip \ 
-0 jasmine.zip 





二 














自 是 一 个 测试 了 上 述 定 义 的 每 个 类 的 单元 测试 ， 可 以 在 Jasmine 上 运行 : 


// 使 用 beforeEach 测 试 Animal 
describe("Animal", function() { 


beforeEach(function() { 
animal = new Animal(); 


}); 


it("should be able to speak", function() { 





expect(animal.speak()).toEqual("Animal is speaking."); 
]); 
]); 


// Dog 继 承 自 Animal, 重 写 了 speak 方 法 
// 测试 中 使 用 了 一 个 局 部 变量 
describe("Dog", function() { 


it("should be able to speak", function() { 
var dog = new Dog(); 
expect(dog.speak()).toEqual("woof"); 
]); 
]); 


// 还 能 更 简洁 一 点 :Cat 继 承 自 Animal 
// 在 一 行内 同时 调用 构造 函数 和 speak 方 法 
describe("Cat", function() { 





it("should be able to speak", function() { 
expect((new Cat()).speak()).toEqual("meow"); 
]); 


]); 
最 简单 的 测试 方式 是 在 浏览 器 里 打开 SpecRunner.html， 结 果 如 图 2-4 所 示 。 





@ee Jasmine Spec Runner ww 
@ file:///Users/cs/Desktop/bookprojects/client-server-web-apps/Chapt” C 





Jasmine 1.3.1 revision 1354556913 finished in 0.027s 
二 和 二 
Passing 3 specs No try/catch@ 
Animal 


should be able to speak 


Dog 
should be able to speak 


Cat 
should be able to speak 














图 2-4: 使 用 Jasmine 的 例子 


如 果 需 要 在 文件 每 次 改动 后 自动 运行 测试 ， 需 要 安装 Node.js (http://nodejs.org/)。 可 以 通 
过 如 下 查看 Node.js 的 命令 确认 是 否 成 功 安装 了 Node.js: 





node --version 
vO.8.15 
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还 需要 安装 Node.js 的 包 管理 工具 ， 


npm --version 
1.1.66 


安装 了 这 些 后 ， 就 可 安装 Karma: 
npm install karma 

安装 成 功 后 ， 可 通过 如 下 命令 查看 帮助 : 
karma --help 


项 目的 配置 文件 通过 init 命令 生成 ， 该 命令 会 生成 一 个 karma.conf.js 文件 ， 后 续 可 以 修改 
此 文件 ， 使 其 指向 项 目 中 的 JavaScript 文件 ， 在 浏览 器 里 运行 。 一 经 配置 ， 使 用 start 选 
项 ， 就 可 以 在 每 次 更 改 文 件 后 自动 运行 单元 测试 。 




















使 用 npm 安装 docco 模块 ， 用 以 生成 文档 : 


npm install docco 





运行 docco 命令 会 在 docs 文件 夹 生 成 HTML 文档 。 图 2-5 展示 了 生成 的 文档 。 注 释 在 左 ， 
高 亮 语 法 显示 的 代码 在 右 。 可 以 通过 右上 角 的 下 拉 列 表 选 择 要 显示 的 其 他 文件 : 














docco app/*.js 


安装 Pygments 


如 果 你 看 见 如 下 信息 :“Could not use Pygments to highlight the source”， 这 是 
指 一 个 叫 Pygments (http://pygments.org/) 的 使 用 Python 编写 的 语法 高 亮 显 
示 工 具 。 


在 Mac 或 Linux 系统 下 ， 使 用 如 下 命令 安装 : 





sudo easy_install pygments 


我 们 快速 浏览 了 JavaScript 对 开发 的 支持 。 使 用 其 中 的 一 些 工 具 ， 能 有 效 提高 代码 的 质量 
和 可 维护 性 。 








本 章 只 是 概述 了 这 门 复杂 且 普 遍 使 用 的 语言 。 对 于 这 里 所 讲述 的 内 容 ， 其 他 图 书 提供 ] 
更 为 深入 的 讲解 。 比 如 由 Alex McCaw 所 著 的 Java Script Web Applications (http://www.bit. 
ly/js-web-applications?cc=73c675463d90439868abb117faf4f9a2，O'Reilly 出 版 ) 一 书 讲解 了 
构建 大 型 JavaScript 应 用 所 使 用 的 模式 (模型 -视图 -控制 器 ) 和 相关 技术 。 由 Nicholas 
C. Zakas 所 著 的 Maintainable JavaScript (http://shop.oreilly.com/product/0636920025245.do， 
O’Reilly 出 版 ) 一 书 讲解 了 编写 可 维护 、 可 扩展 的 JavaScript 代码 的 实践 和 标准 。 当 然 ， 还 



































30 | 第 2 章 


有 很 多 在 线 资源 ， 比 如 Mozilla Developer Network (https://developer.mozilla.org/en-US/docs/ 
Web/JavaScript) 和 StackOverflow (http://stackoverflow.com/questions/tagged/javascript?sort= 
frequent&pagesize=15 ) 。 








e@oe Animal.js ww 
bd 二 | © file:///Users/cs/Desktop/bookprojects/client-server-web-apps/Chapter-2-JavaScript-And-Tools/Animals/docs 6| Readerc 





JUMP TO .- 


Animal.js 

Animal is the top of the object hierarchy function Animal() {} 

Define a speak function that have specific implementations in Animal.prototype. speak = function() { 
subclasses return "Animat is speaking."; 


}; 











图 2-5，Docco 截图 


a 它 有 自己 迅速 发 展 的 生态 系统 ， 其 开发 工作 有 很 多 项 目 支持 。 了 解 
一 语言 和 相关 开发 工具 ， 这 会 为 你 探索 后 续 将 要 介绍 的 很 多 框架 和 类 库 打 下 基础 。 
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第 3 章 


REST 和 JSON 





“好 因 钨 造 出 好 邻 家 
一 一 罗伯特 。 弗 罗 斯 特 





一 旦 引入 一 种 技术 ， 人 们 的 第 一 反应 是 它 不 能 做 什么 。 对 那些 习惯 于 在 限定 范围 内 工作 的 
人 来 说 ， 这 种 反应 会 让 他 们 感到 迷恋 。 从 负面 的 角度 来 看 “篇 多”"， 它 增加 了 限制 ， 从 正 
面 的 角度 看 ， 正 如 罗伯特 . 弗 罗 斯 特 说 的 那样 ， 它 明确 了 界限 、 上 暗示 了 用 意 和 六 在 的 危险 。 
同样 的 道理 ， 软 件 系统 的 约束 提供 了 更 好 的 功能 、 效 率 ， 明 确 了 角色 。 好 的 约束 不 在 于 
限制 ， 而 是 为 了 达到 正 向 的 结果 。REST 是 一 种 架构 风格 ， 它 由 一 系列 约束 组 成 ， 描 述 了 
Web (或 者 类 似 结构 ) 应 该 如 何 工作 。 这 些 约束 虽然 增加 了 限制 ， 但 是 却 孕 育 了 适合 Web 
本 质 的 系统 设计 。 











对 于 REST 的 描述 ， 通 常 以 这 样 一 种 观点 开始 : REST 是 一 种 Web 服务 协议 。 这 样 理解 没 
问题 ， 尤 其 是 和 SOAP 或 其 他 消息 服务 做 类 比 时 。 和 SOAP 相 比 ， 人 们 认为 REST 是 一 种 
简化 的 协议 ， 缺 少 实现 SOAP 时 必需 的 扩展 定义 和 额外 结构 。REST 直接 依赖 底层 HTTP 
协议 的 功能 ， 包 括 请 求 方法 、URI 地址 和 响应 代码 。REST 也 可 以 和 远程 过 程 调用 (RPC) 
风格 的 API 来 对 比 ， 远 程 过 程 调用 用 URL 表示 行动 ,REST 用 URL 访问 资源 。 这 样 说 来 ， 
REST 是 面向 名 词 的 ， 而 RPC 是 面向 动词 的 。 
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为 什么 选择 REST， 而 不 是 SOAP? 
关于 REST 和 SOAP 就 好 就 坏 的 辩论 不 绝 于 耳 。SOAP 提供 了 规范 的 约定 ， 适 合 复 
的 RPC 架构 ， 但 对 大 多 数 Web 开发 来 说 ， 它 引入 了 额外 的 开销 和 复杂 度 ， 而 且 了 好 
有 明显 的 好 处 。SOAP 依然 作为 一 个 RPC 平台 被 大 量 使 用 ， 但 这 并 非 出 于 技术 因素 ， 
很 多 时 候 只 是 因为 现 有 的 大 型 系统 里 大 量 油 用 了 SOAP。 


SOAP 消息 脐 肿 ， 需 要 大 量 处 理 ， 而 且 使 用 烦琐 的 XML 信封 来 表示 。 这 使 得 客户 六 - 服 
务 器 详 的 Web 应 用 对 该 协议 提 不 起 兴趣 ， 尽 管 它 可 以 很 容易 地 使 用 JavaScript 处 理 JSON。 


杂 
没 




















很 多 开发 者 开始 接触 REST 时 ， 都 将 其 作为 一 种 拥有 整齐 的 URL 和 自由 轻 量 消息 的 Web 
服务 协议 。 从 这 个 角度 理解 REST 自 有 其 实用 价值 ， 但 以 其 作者 罗 伊 * T. 菲 尔 丁 (Roy TT. 
Fielding) 的 表述 来 理解 REST 更 为 重要 。 



































3.1 什么 是 REST 


非 尔 丁 (http:/www.ics.uci.edu/~fielding/pubs/dissertation/web_arch_domain.htm) 说 :“ 表 述 
性 状态 转移 (REST) 架构 是 为 了 建 模 描述 现代 Web 如 何 工作 而 开发 的 。” 从 技术 上 说 , 它 
是 与 协议 无 关 的 ， 但 却 是 和 HTTP 一 起 发 展 起 来 的 。 由 于 这 层 关系 ， 需 要 将 一 些 重要 的 
HTTP 功能 谨 记 于 心 。 








3.1.1 资源 
Web 资源 是 存在 于 Web 之 上 的 某 种 东西 ， 它 的 定义 随 着 时 间 不 断 演变 。 起 先 ， 资 源 是 指 
拥有 静态 地 址 的 文档 或 文件 。 后 来 它 的 定义 变 得 越发 抽象 ， 到 现在 ， 资 源 泛 指 Web 上 一 切 
可 识别 、 可 命名 、 可 找到 并 被 处 理 的 实体 。 比 如 传统 的 HTML 页 面 、 文 档 、 音 频 文件 、 图 
片 等 。 资 源 还 可 能 指 代 那些 在 传统 数字 图 书馆 中 找 不 到 的 东西 ， 比 如 硬件 、 人 或 者 一 组 其 
他 资源 的 集合 。 


REST 使 用 Web 地 址 (URI) 访问 资源， 使 用 动词 (HTTP 请 求 ) 操作 资源 。 

















3.1.2 动词 (HTTP 请求) 

HTTP 1.1 定义 了 一 组 动词 (或 者 HTTP 请 求 ) ， 来 表示 施 予 资源 的 某 种 行为 。 有 了 这 些 方 
法 ，RESTful 的 方式 就 是 使 用 GET、POST、PUT 和 DELETE。 可 以 这 样 理 解 这 些 动词 : 
就 像 操作 数据 库 中 的 数据 时 使 用 到 的 命令 。 


在 数据 库 里 ， 通 常用 记录 代表 数据 实体 ， 在 REST 中 ， 对 应 的 实体 是 资源 。HTTP 动词 
(POST/GET/PUT/DELETE) 和 在 数据 库 或 对 象 关 系 管理 (ORM) 系统 中 传统 的 CRUD 
(Create/Read/Update/Delete) 操作 对 应 。REST 架构 规定 : 访问 或 修改 Web 上 的 资源 ， 和 
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访问 或 修改 数据 库 中 的 记录 一 样 ， 需 要 使 用 SQL 或 其 他 查询 的 语言 。 请 阅读 附录 B 获取 
HTTP 1.1 中 和 REST 有 关 的 选项 清单 。 





HTTP 动 词 对 资源 的 操作 ”对 应 的 数据 库 操作 

















POST 新 建 〈 或 追加 ) ”insert 
GET 获取 Select 
PUT 更 新 (或 新 建 ) update 
DELETE I 除 delete 








其 他 HTTP 方法 


还 有 其 他 一 些 HTTP 方法 也 很 有 用 ， 不 过 无 法 和 传统 的 CRUD 数据 库 操 作对 应 。 
HEAD 方法 和 GET 相同， 区 别 在 于 前 者 的 响应 不 包含 响应 体 。 这 在 利用 HTTP 头 的 
REST 相关 技术 中 变 得 很 实用 。 基 于 浏览 器 的 同 源 安全 策略 ， 跨 域 资 源 访问 是 被 禁止 
的 ， 跨 域 资源 共享 (CORS) 技术 通过 HTTP 头 和 服务 器 通信 ， 返 回 JSON。 有 一 些 方 
法 在 HTTP 头 中 存放 文档 链接 ， 时 不 时 会 出 现 重 要 信息 放 在 响应 头 而 不 是 响应 体 中 的 
情况 ， 此 时 使 用 HEAD 调用 方法 就 有 意义 ， 而 不 必 像 标准 的 GET 方法 那样 花费 额外 
的 开销 返回 响应 体 。 


HTTP OPTIONS 能 获取 对 一 个 资源 可 用 的 HTTP 请 求 ， 这 不 仅 便于 调试 和 支持 ， 而 且 
能 帮助 创建 一 个 统一 接口 的 、 自 描述 的 系统 ， 所 有 链接 都 通过 一 个 接 入 点 访问 。 结 合 
这 些 代表 系统 中 所 有 资源 访问 点 的 链接 ， 使 用 HTTP OPTIONS 实现 的 系统 可 以 通过 一 
个 链接 ， 返回 每 个 资源 可 用 方法 的 完整 列表 。 











3.1.3 统一 资源 标识 符 

在 网 络 系统 中 ， 需 要 某 种 形式 的 句柄 或 地 址 以 访问 资源 。 统 一 资源 标识 符 (URI) 泛 指 实 
现 这 一 功能 的 字符 串 。URI 可 进一步 划分 为 统一 资源 名 (URN， 代 表 资 源 的 名 字 ) 和 统一 
资源 定位 符 (URL， 代 表 资 源 的 地 址 )。 





大 多 数 URL 遵循 如 下 格式 : 


<scheme>://<user>:<password>@<host>:<port>/<path>; <parameters>?<query 
key/value pairs>#<fragment identifier> 


请 参考 《HTTP 权威 指南 》 : 以 获取 更 多 关于 URI 和 HTTP 的 知识 。 


在 REST 中 ， 通 过 元 素 路 径 指定 资源 ，URL 中 的 斜 杠 界定 了 资源 ， 并 且 表 示 了 资源 之 间 的 
层级 关系 。REST URL 的 示例 和 更 详细 的 解释 详 见 第 8 章 。 











在 基于 Web 的 API 中 ， 人 们 使 用 URL 定位 资源 ， 并 且 依 照 一 些 附 加 约定 表明 资源 之 间 














注 1: 本 书 已 经 由 人 民 邮 电 出 版 社 出 版 。 
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的 关系 。 在 REST 中 ， 这 不 是 必需 的 ， 只 是 出 于 对 URL 的 可 读 性 和 一 致 性 所 采用 的 一 
种 风格 约定 。 大 部 分 情况 下 ，URL 应 使 用 小 写字 母 ， 使 用 连 字 符 而 不 是 下 划 线 ， 结 尾 使 
用 斜 枉 。 单 个 资源 使 用 单数 名 词 指 代 ， 一 组 资源 使 用 复数 名 词 指 代 。 不 鼓励 使 用 文件 后 
级 ， 但 当 API 支持 多 种 格式 ， 比 如 XML 和 JSON 时 ， 可 使 用 文件 后 级。 使 用 “Accept” 
和 “Content-Type” 头 来 控制 格式 ， 是 一 种 更 好 的 替代 方案 。Mark Masse 所 著 的 REST 4P7 
Design Rulebook(O”Reilly) 一 书 列举 了 上 面 提 到 的 一 些 约定 及 其 他 ， 但 是 在 实践 中 ，URL 
的 结构 和 格式 有 很 多 种 可 能 。 






































使 用 连 字符 替代 下 划 线 ? 
需要 指出 ， 上 文 提 到 的 URL 命名 规范 不 是 金 科 斑 律 。 很 多 流行 的 API， 包 括 Twitter 
(https://dev.twitter.com/overview/documentation) 和 Dropbox (https:/www.dropbox.com/ 
developers/core/docs) 都 在 使 用 下 划 线 。 在 过 去 ， 有 很 多 因素 ， 比 如 搜索 引擎 优化 让 下 
划 线 成 为 一 种 不 好 的 实践 (在 Google 的 搜索 引擎 索引 里 ， 以 下 划 线 连接 的 元 素 会 被 事 
联 起 来 ， 而 使 用 连 字 符 的 字符 囊 则 可 分 解 成 单词 )。 关 于 细节 ， 有 很 多 不 同 的 意见 ， 但 
人 们 部 明确 同意 ;: URL 应 该 越 短 越 好 ， 易 读 、 清 晰 ， 并 在 API 间 保持 一 致 。 











3.2 ”REST 约 束 


REST 是 由 一 组 挑选 的 约束 定义 的 软件 架构 风格 (http://www .ics.uci.edu/~fielding/pubs/ 
dissertation/rest_arch_style.htm)。 遵 循 这 些 约束 设计 的 系统 ， 体 现 出 了 有 益 的 系统 属性 和 展 
好 的 工程 原则 。 


3.2.1 ”客户 端 - 服 务 器 端 

客户 端 - 服务 器 端 架构 直截了当 地 划分 开 了 职责 。 它 最 大 化 地 利用 了 现代 客户 端的 处 理 能 
力 一 一 这 种 能 力 以 往 只 在 高 端 电脑 上 上 有 具备。 服务 器 端 将 很 多 职责 转移 到 客户 端 ， 使 自身 得 
到 了 极 大 简化 。 这 样 的 系统 易于 扩展 ， 分 成 不 同 层 让 各 层 之 间 可 以 独立 开发 。 




















3.2.2 无 状态 

REST 要 求 无 状态 的 设计 ， 会 话 数据 保存 在 客户 端 。 客 户 端 的 每 次 请 求 必须 “上 下 文 无 关 ” 
和 自 包 含 的 。 也 就 是 说 ， 请 求 要 包含 整个 客户 端 状态 。 这 要 求 服务 器 端 在 不 通过 额外 查询 
应 用 状态 的 情况 下 ， 响 应 所 需要 的 所 有 数据 ， 并 获得 与 应 用 状态 相关 的 数据 。 因 为 所 有 的 
数据 都 包含 在 了 请 求 里 ， 使 得 每 次 交互 的 意图 理解 起 来 变 得 容易 。 因 为 会 话 数 据 不 在 服务 
器 端 维护 ， 容 错 性 和 可 扩展 性 都 得 到 提升 。 服 务 器 资源 不 会 浪费 在 存储 上 ， 否 则 就 需要 重 
新 获取 。 


设计 符合 REST 无 状态 本 质 的 系统 有 很 多 挑战 。 挑 战 之 一 是 更 多 和 更 频繁 的 请 求 带 来 的 
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额外 网 络 流量 〈 可 以 通过 维护 服务 器 状态 的 非 RESTful 客户 端 - 服务 器 端 应 用 来 保持 服 
务 器 端 会 话 以 减少 流量 )。 所 有 的 请 求 都 包含 状态 相关 数据 ， 那 么 一 定 有 一 些 数据 被 重 
复发 送 。 服 务 器 不 维护 会 话 这 一 点 ， 意 味 着 客户 端 有 了 更 多 的 职责 ， 因 此 会 变 得 更 复杂 
(这 是 现代 RESTful 应 用 中 ，JavaScript 变 得 越 来 越 复 杂 的 原因 之 一 )。 浏 览 器 存储 在 这 
种 系统 中 变 得 格外 有 趣 。 由 于 REST 系统 通常 支持 多 种 客户 端 ， 在 客户 端 花 些 时 间 和 精 
力 计划 是 必需 的 。 


虽然 挑战 很 多 ,但 无 状态 带 来 的 好 处 是 巨大 的 ， 尤 其 在 部 署 多 服务 器 时 ， 通 过 负载 均衡 分 
发 请 求 的 情况 下 。 如 果 使 用 基于 服务 器 端的 会 话 ， 有 两 种 选择 。 第 一 种 选择 是 要 求 对 于 指 
定 会 话 ， 使 用 同一 个 服务 器 响应 所 有 请 求 。 第 二 种 选择 是 创建 一 个 可 供 所 有 服务 器 访问 的 
集中 式 会 话 存储 区 ， 每 次 作出 请 求 ， 都 需 访 问 这 个 集中 式 的 数据 存储 区 。 该 实践 (有 时 称 
为 会 话 关联 或 粘连 会 话 ) 让 扩展 变 得 更 难 。 大 规模 部 署 通常 要 求 随时 向 服务 器 发 布 更 新 ， 
如 有 果 使 用 服务 器 端 会 话 ， 必 须 等 待 旧 会 话 失 效 后 ， 才 能 将 接 入 请 求 集成 进 安装 更 新 后 的 服 
务 器 。 这 是 一 个 复杂 、 难 于 操作 的 过 程 。 如 有 果 服 务 器 端 不 保存 状态 ， 就 不 会 有 这 些 麻 烦 。 
而 且 ， 浏 览 器 的 标准 功能 ， 比 如 返回 前 一 个 页 面 或 重新 加 载 当 前 页 面 ， 在 消除 服务 器 端 维 
护 的 会 话 后 ， 都 不 需要 特殊 处 理 即 可 实现 。 

REST 的 无 状态 设计 对 很 多 开发 者 来 说 ， 是 最 难 理解 的 特性 。 它 需要 对 传统 Web 开发 实践 
做 出 极 大 调整 。 由 于 每 个 请 求 都 包含 状态 带 来 的 性 能 损耗 也 不 是 无 法 克服 的 ， 尤 其 是 在 考 
虑 到 有 很 多 REST 约束 的 时 候 ， 好 处 很 多 。 






































































































































3.2.3 ”可 缓存 

由 REST 的 无 状态 约束 带 来 的 性 能 问题 在 很 大 程度 上 可 以 通过 缓存 来 弥补 。REST 要 求 给 
数据 打 标签 ， 标 明 其 是 否 可 被 缓存 。 这 使 得 客户 端 应 用 能 重用 缓存 的 响应 ， 而 不 是 此 后 发 
送 同等 的 请 求 。 和 任何 系统 的 缓存 一 样 ， 这 会 极 大 提高 客户 端 应 用 性 能 ， 但 与 此 同时 ， 为 
避免 数据 过 期 ， 采 用 合适 的 缓存 失效 策略 带 来 了 复杂 性 。 以 Web 来 说 ， 缓 存 可 以 存在 于 客 
户 端 (浏览 器 里 )、 服 务 器 端 ， 或 者 位 于 二 者 之 间 (网 关 或 代理 服务 器 )。 




















3.2.4 统一 接口 

统一 接口 规定 了 所 有 RESTful 应 用 的 通用 资源 定位 方式 。 每 一 个 REST 应 用 都 共享 一 种 
通用 架构 ， 那 些 熟 悉 这 种 架构 的 人 一 眼 就 能 看 明白 。 因 此 ， 为 特定 应 用 需求 定制 接口 的 能 
力 会 受到 严重 限制 。 不 过 ， 该 约束 也 提供 了 很 多 灵活 性 。HTTP 的 每 个 版 本 都 在 演进 ， 为 
RESTful 设计 提供 了 额外 的 机 制 ( 比 如 新 增 的 请 求 类 型 )。 该 约束 由 其 他 一 些 限制 构成 ( 见 
表 3-1)。 
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表 3-1: 统一 接口 约束 

































































统一 接口 约束 描述 

标识 资源 通过 URI 定位 资源 

通过 表示 操纵 资源 资源 需要 表示 ， 它 的 表示 形式 就 是 请 求 发 送 的 内 容 ( 即 XML/JSON 文档 ) 
自 描述 的 消息 使 用 HTTP 动词 的 无 状态 请 求 

使 用 超 媒体 作为 应 用 状态 引擎 HATEOAS: 能 指明 应 用 状态 转变 的 可 用 链接 

3.2.5 ”分 层 








分 层 设计 能 让 网 络 模块 和 每 条 请 求 按 序 交 互 。 每 个 模块 不 能 越过 正在 通信 的 层级 访问 其 他 
层 。 这 意味 着 常用 的 网 络 设备 ， 比 如 防火 墙 、 网 关 能 继续 使 用 ， 可 以 使 用 代理 服务 器 进行 
缓存 或 转换 。 


3.2.6” 按 需 交 付 代码 

REST 允许 通过 JavaScript 或 陪 入 浏览 器 的 应 用 按 需 交 付 代 码 ， 但 这 不 是 必须 的 。 这 为 扩展 
应 用 提供 了 更 多 可 能 性 。 其 缺点 是 降低 了 根植 于 RESTful 系统 中 的 可 见 性 (特别 是 像 Java 
Applet 这 样 的 对 象 ) 。 


3.3 HTTP 响应 代码 


开发 REST API 时 ， 标 准 HTTP 状态 码 ( 详 见 附录 B) 为 客户 端 提供 反馈 、 报 告 潜在 错误 。 
响应 的 本 质 ， 直 接 依赖 使 用 的 HTTP 请 求 。 


什么 是 成 功 

关于 如 何在 Web API 中 使 用 HTTP 响应 代码 ， 业 界 还 未 普遍 达成 一 致 。 这 一 方面 是 因为 响 
应 没有 和 HTTP 动词 对 应 ， 而 是 分 成 5 种 类 型 : 概要 信息 、 成 功 的 请 求 、 重 定向 、 客 户 端 
错误 、 服 务 器 端 错误 。 在 某 些 情况 下 ， 响 应 代码 意义 明确 ， 另 一 些 时候 则 依赖 具体 的 API 
调用 或 API 设计 者 的 选择 。 


以 成 功 代码 (200) 为 例 ， 在 大 多 数 情况 下 ， 这 是 一 个 GET 请 求 成 功 后 返回 的 恰当 代码 。 
事实 上 , 在 HTTP 1.1 (http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html) 规范 里 ， 它 
被 列 为 GET 和 POST 请 求 的 响应 代码 。 响 应 取决 于 HTTP 的 请 求 类 型 ， 如 表 3-2 所 示 。 
























































表 3-2: HTTP 1.1 成 功 响应 代码 (200) 
HTTP 动 词 。 ”期望 的 响应 内 容 





























GET 和 请 求 资源 对 应 的 实体 

HEAD 值 返回 和 请 求 资源 对 应 的 entity-header 属性 ， 不 返回 消息 体 
POST 描述 或 包含 动作 结果 的 实体 

TRACE 包含 服务 器 端 收 到 请 求 信息 的 实体 
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也 有 人 使 用 HTTP 200 作为 PUT 或 DELETE 请 求 的 响应 代码 ， 也 可 能 使 用 其 他 代码 。 有 些 
API 使 用 HTTP 201 (新 建 ) 来 响应 PUT 或 POST 请 求 。204 (无 内 容 ) 可 能 用 于 DELETE 
请 求 ， 不 返回 其 他 响应 ， 如 果 请 求 成 功 但 服务 器 故意 不 返回 内 容 的 话 ， 也 可 能 用 于 其 他 动 
词 (甚至 是 GET)。 如 果 Web 应 用 使 用 基本 认证 ， 可 返回 HTTP 401 (未 认证 ) 注销 登录 。 
因此 ， 什 么 是 成 功 ， 需 要 结合 上 下 文 来 考虑 ， 选 择 合适 的 响应 代码 需要 理解 代码 的 含义 和 
请 求 的 性 质 。 


响应 代码 的 第 一 个 数字 指明 了 响应 的 种 类 。 客 户 端 至 少 要 识别 响应 的 种 类 ， 使 用 响应 代码 
要 求 一 定 的 灵活 性 和 变化 ( 见 表 3-3)。 


表 3-3: HTTP 响 应 代码 的 种 类 
第 一 个 数字 含义 
































1 信息 

2 成 功 

3 重 定向 

4 客户 端 错误 
5 服务 器 错误 


Mozilla (https://developer.mozilla.org/en-US/docs/Web/HTTP/Response_codes)、Yahoo 
Social API (https://developer.yahoo.com/social/rest_api_guide/http-response-codes.htm]l) 
和 REST API Design Rulebook (http://shop.oreilly.com/product/0636920021575.do) 一 书 
都 周到 细致 地 展示 了 响应 代码 的 使 用 。 相 似 性 强调 了 出 现 的 约定 和 最 佳 实践 ， 不 同 点 则 
展示 了 对 于 设计 给 定 API 时 ， 根 据 其 特质 所 选用 的 不 同 设计 和 区 别 。 





3.4 JSON 


道格拉斯 . 克 罗 克 福 德 大 名 鼎鼎 ， 不 是 因为 他 强调 了 JavaScript 语言 的 方方面面 ， 而 是 因 
为 他 专注 于 一 个 子 集 。 简 言 之 ， 他 对 如 何 使 用 语言 加 了 自己 的 限制 。 他 的 另 一 创新 是 设计 
了 脱胎 于 JavaScript 语言 、 用 于 数据 交换 的 JSON (JavaScript Object Notation ) 。 


从 现代 计算 机 技术 出 现 伊 始 ， 就 有 各 种 各 样 的 数据 交换 格式 。 除 了 二 进 制 和 一 些 私 有 的 格 
式 ， 很 多 格式 希望 能 兼 具 人 类 和 机 器 的 可 读 性 。 起 初 ， 人 们 使 用 定 长 和 分 隔 的 文件 格式 
(此 格式 现在 仍然 有 人 在 用 )。1996 年 ， 人 们 拟定 了 XML 第 一 版 草案 ， 兼 顾 了 人 类 和 机 器 
的 可 读 性 ， 但 因 其 元 长 和 不 必要 的 复杂 性 ， 一 直 饱 受 大 家 诉 病 。 为 此 ， 一 些 具 备 XML 某 
些 特性 ， 比 如 层级 结构 的 语言 被 发 明 出 来 (比如 YAML)。2002 年 ， 道 格拉 斯 . 克 罗 克 福 
德 购买 了 http://www.json.org 域名 ， 他 将 JSON 描述 如 下 : 


。 一 种 数据 交换 格式 (对 XML 的 一 种 轻 量 级 赫 代 品 ) ; 
。 一 种 编程 语言 模型 ， 是 JavaScript 语言 的 一 个 子 集 ， 
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。 一 种 易于 解析 的 格式 (事实 上 ， 如 果 使 用 JavaScript 语言 ， 可 对 JSON 字符 串 调 用 eval() 
方法 ， 就 可 将 其 转换 为 JavaScript 对 象 ， 虽 然 这 样 做 有 点 不 太 安 全 )。 


同时 ， 他 强调 了 JSON 优 于 XML 的 地 方 ， 如 下 。 





。 相 比 XML， 响应 体 更 小 。 在 XML 中 ， 起 始 和 结束 标签 ， 以 及 元 数据 需要 额外 的 空间 。 
。 JSON 和 Web 的 互通 性 更 强 。JSON 是 JavaScript 的 子 集 ,这 让 客户 端 集成 变 得 易如反掌 。 
。 上 述 特性 带 来 了 性 能 上 的 提升 ， 也 使 Ajax 调用 中 的 集成 工作 变 得 简单 。 





当然 ，JSON 也 有 一 些 “ 不 值 一 提 ” 的 奇怪 行为 ， 如 下 。 


。 JSON 不 完全 是 合法 的 (http://timelessrepo.com/json-isnt-a-javascript-subset) JavaScript。 

。 JSON 中 无 法 添加 注释 。 

。 如 前 所 述 , JSON 是 JavaScript 的 子 集 , 因此 可 使 用 JavaScript 的 eval() 方法 求 值 。 但 是 ， 
eval() 方 法 是 危险 的 (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/ 
Global_Objects/eval#Don.27t_use_eval.21)。 人 们 常 说 “eval() is 独 恶 的 (evil)”。 

。 大 多 数 现代 浏览 器 强制 使 用 “ 同 源 策略 ”"， 这 使 得 来 自 其 他 网 站 的 JSON 无 法 求 值 。 人 
们 使 用 JSONP (或 者 JSON-P、 带 填充 的 JSON) 从 其 他 域 里 的 服务 器 上 请 求 数据 ( 通 
过 HTTP GET)， 在 调用 者 的 环境 中 ， 已 经 定义 了 一 个 函数 用 来 维护 JSON 数据 ， 这 就 
是 为 什么 要 称 作 “ 填 充 ” 的 原因 。 最 近 ， 人 们 开发 出 了 CORS ( 跨 域 资源 共享 ，http:// 
www.w3.org/TR/cors/) 技术 ， 作 为 一 种 更 有 活力 、 更 安全 的 技术 ， 有 望 取 代 JSONP。 
CORS 使 用 HTTP 头 ， 让 来 自 指定 域 的 服务 器 提供 资源 。 同 时 需要 在 服务 器 端 做 相应 配 
置 以 生成 JSON。 











JSON 中 的 注释 


JSON 里 不 允许 注释 这 一 点 有 些 莫名 其 妙 ， 因 此 出 现 了 很 多 变通 方法 。 方 法 
之 一 是 向 JSON 对 象 增加 一 个 “comment” 元 素 ， 然 后 将 注释 内 容 当 作 元 素 的 
值 。 这 里 要 避免 创建 两 个 同名 元 素 ， 并 且 默 认 解析 器 会 选择 最 后 一 个 。 比 如 : 


({"a":"This is a comment", "a":"CONTENT"}) 

















虽然 该 片段 能 被 很 多 JSON 解析 器 解析 ， 但 这 和 实现 有 关 ， 并 不 是 规范 中 定 
义 的 行为 。 





3.5 HATEOAS 


JSON 是 一 种 非常 简单 和 紧凑 的 格式 。 和 其 他 为 表示 数据 提供 复杂 类 型 系统 的 格式 不 同 ， 
JSON 只 提供 了 有 限 的 几 种 数据 类 型 ， 包 括 字符 串 、 数 字 、 布 尔 值 、 对 象 、 数 组 和 nutlL 
对 于 大 多 数 应 用 来 说 ， 这 些 数据 类 型 的 表达 能 力 和 扩展 性 已 经 足够 强 。 由 于 JSON 作为 一 
种 在 RESTful API 中 广泛 使 用 的 数据 交换 类 型 ， 读 者 可 能 会 希望 有 一 种 类 型 来 表示 超 链 接 ， 
但 是 这 样 的 类 型 是 不 存在 的 ! 这 是 有 问题 的 ， 特 别 是 当 REST 包含 一 种 超 媒 体 作 为 应 用 状 
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态 引 掌 (Hypermedia as the Engine of Application State，HATEOAS) 的 约束 时 。 


该 约束 限定 客户 端 通过 链接 ( 即 超 媒体 ) 交互 。 因 此 ， 从 严格 意义 上 来 说 ， 如 果 JSON 或 者 
JavaScript (这 是 前 者 的 基础 ) 没有 链接 数据 类 型 ,一 个 Web API 就 不 能 称 为 “RESTful”API。 











基于 XML 的 REST API 通常 使 用 Atom 供稿 格式 (这 里 链接 包含 rel、href、hreflang 和 
type) 或 报 文 头 中 的 链接 。 同 样 的 ， 人 们 也 开发 出 了 包含 标准 链接 的 JSON 扩展 : 








。 HAL (http://stateless.co/hal_specification.html) ; 

。 Siren (https://github.com/kevinswiber/siren) ; 

。 JSON-LD (http:Wjson-ld.org/) ; 

。 JSON Reference (http://tools.ietf.org/html/draft-pbryan-zyp-json-ref-00) ; 

。 _ Collection+JSON (http://amundsen.com/media-types/collection/format) ; 

。 JSON API (http://jsonapi.org/about/， 从 Ember JS REST Adapter 提取 而 来 ， Ember JS 
REST Adapter 参见 http://emberjs.com/)。 





W3C 在 其 官网 上 有 一 篇 文章 “JSON-based Serialization for Linked Data” (http://www.w3.org/ 
TR/json-ld-syntax/， 本 书写 作 之 时 其 状态 为 “W3C Recommendation 16 January 2014” ) 。 








不 论 表 示 的 实体 如 何 ， 很 多 链接 都 有 相似 的 类 型 或 关系 。 以 集合 为 例 ， 可 以 引用 第 一 个 、 
最 后 一 个 、 下 一 个 或 前 一 个 元 素 。 帮 助 、 术 语 表 或 者 关于 链接 在 很 多 情境 中 都 是 相关 的 。 
由 于 有 了 这 些 共性 ， 人 们 就 试图 将 链接 之 间 的 关系 (http://www.iana.org/assignments/link- 
relations/link-relations.xml) 标准 化 (http://tools.ietf.org/html/rfc5988)。 建 立 了 关系 之 后 的 链 
接 能 让 自动 生成 的 链接 更 加 具体 和 可 靠 。 


















































了 解围 绕 HATEOAS 的 讨论 和 工作 是 有 价值 的 ， Ee 终结 果 是 什么 样子 ， 现 在 还 无 从 知 
晓 。 事 情 远 比 想象 的 复杂 ， 每 个 API 设计 是 否 要 完全 遵守 这 一 规则 也 尚未 达成 一 致 。 








超 链接 连接 能 力 的 连续 性 
出 现在 Web 上 的 资源 ， 其 连接 能 力 千 差 万 别 。 一 方面 ， 一 些 格式 需要 定义 严格 的 链 
接 ; 一 方面 ， 另 一 些 格式 却 禁止 使 用 链接 。 


格式 ”描述 示例 






































1 自动 生成 的 标准 链接 “Atom Publishing Protocol (APP) 

2 人 为 指定 的 标准 链接 XHTML 

3 扩展 形式 的 链接 链接 作为 已 有 格式 的 扩展 (HAL，http://stateless.co/hal_specification.html) 
4 字符 链接 作为 链接 的 字符 串 

5 无 链接 特殊 的 交换 格式 禁止 使 用 链接 





菲 尔 丁 定义 的 REST 要 求 合理 使 用 格式 1。 很 多 Web API 受 REST 启 发， 有 可 能 选用 
其 他 格式 。 
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REST 和 JSON 

随 着 REST 被 用 于 除 Web 之 外 的 很 多 真实 项 目 ， 逐 渐 体现 出 了 它 的 价值 所 在 〈 正 如 菲 尔 丁 
在 论文 中 表述 的 那样 )。 非 尔 丁 曾经 表达 过 他 对 那些 冠 以 RESTful 标签 ， 却 不 是 超 链 接 驱 
动 (http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven) 的 API 的 失望 : 








REST 是 着 眼 于 长 久 的 软件 设计 : 每 个 细节 都 提倡 软件 的 持久 性 和 独自 进化 。 很 
多 限制 直接 牺牲 了 短期 效率 。 遗 憾 的 是 ， 人 们 擅长 短期 设计 ， 在 长 期 设计 上 却 表 
现 糟 糕 。 大 多 数 人 认为 在 当前 版 本 发 布 后 ， 不 会 再 去 设计 。 有 很 多 软件 方法 将 长 
期 设计 刻画 为 错误 的 、 象 牙 塔 里 的 设计 ( 没 错 ， 如 果 设 计 不 是 由 真实 需求 驱动 ， 
会 变 成 这 样 )。 


菲 尔 本 将 REST 定位 成 一 种 长 期 的 解决 方案 值得 尊敬 。 他 提出 了 只 要 Web 以 及 背后 的 技术 
保留 基础 结构 就 可 以 长 期 共存 的 想法 。 如 此 说 来 ，HATEOAS 和 JSON 的 关系 就 没有 什么 
值得 调查 、 展 示 和 深究 的 了 。 当 尘埃 落下 ， 我 或 许 会 扩充 或 改写 本 书 ， 加 入 对 这 些 内 容 的 
讨论 。 


总 体 上 来 说 ， 菲 尔 丁 的 观点 非常 重要 ， 他 是 一 位 创新 的 思考 者 ， 他 发 明了 REST。 但 是 ， 
现在 设计 的 很 多 系统 并 不 需要 长 存 于 世 (或 者 卖 很 长 时 间 )。 他 对 REST 的 表述 很 精彩 ， 
值得 大 家 按 他 所 表述 的 意思 去 理解 。 但 是 ，REST 已 经 被 用 在 了 更 广阔 的 环境 里 ， 已 经 成 
为 一 种 识别 微型 Web API 设计 的 架构 风格 的 标志 ， 很 大 程度 上 依赖 于 底层 HITP 的 功能 。 






































实用 的 REST 
为 什么 很 多 API 都 以 这 种 “实用 ”的 方式 来 设计 ? 一 方面 ， 这 是 因为 
HATEOAS 原则 对 客户 端 程 序 员 提出 了 更 高 的 要 求 。 一 个 程序 员 ， 不管 是 有 
意 还 是 无 意 ， 如 果 将 URI 硬 编码 入 应 用 ,会 为 将 来 带 来 很 大 隐患 ， 服 务 器 端 
API 团队 可 以 直截了当 地 告诉 客户 端 程序 员 ， 你 没 能 遵守 规范 。 


虽然 HATEOAS 从 理论 上 说 是 设计 API 的 好 方法 ， 但 是 现实 中 可 能 不 适用 。 在 
设计 时 ， 充 分 考虑 到 API 的 消费 者 ， 以 及 他 们 可 能 使 用 API 的 方式 ， 以 构建 你 
自己 的 应 用 是 很 有 必要 的 。 在 有 些 情况 下 ，HATEOAS 并 不 是 正确 的 选择 。 


——APls: A Strategy Guide ( O’Reilly ) 











在 非 尔 丁 的 论文 中 ， 很 有 意思 地 提 到 了 JavaScript 和 REST 的 关系 (http://www.ics.uci. 
edu/~fielding/pubs/dissertation/evaluation.htm)。 他 讨论 了 JavaScript 和 嵌入 式 的 Java 
“applets” 在 Web 上 的 对 决 ， 为 何 前 者 笑 到 了 最 后 。 他 指出 JavaScript 符合 Web 部 署 模型 ， 
和 HTML 的 可 见 性 原则 保持 一 致 ， 包 含 较 少 的 安全 限制 ， 拥 有 较 短 的 用 户 可 感知 的 延迟 ， 
而 且 不 需要 整个 单独 下 载 。 








入 后 
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传统 的 JavaScript 使 用 方式 和 Web 的 设计 原则 一 致 ， 它 在 六 
JSON 成 为 一 种 吸引 人 的 数据 交换 选择 ， 它 易于 产生 ， 易 于 处 理 。 





览 器 里 的 大 


且 


使 用 ， 使 得 








遗憾 的 是 ，JSON 是 JavaScript 的 一 个 子 集 ， 而 不 是 一 种 超 媒体 格式 ， 这 意味 着 在 JSON 和 
严格 的 RESTful API 之 间 还 存在 骨髓 。 尽 管 浏 览 器 运行 JavaScript 和 Web 的 设计 与 REST 
的 正式 定义 保持 一 致 ， 但 使 用 JSON 交换 数据 却 并 非 如 此 。 





没 人 对 使 用 严格 的 定义 来 区 分 一 个 Web API 是 不 是 RESTful 感 兴 趣 。JSON Web API 是 如 
此 流行 ，REST 设计 的 影响 如 此 广泛 ， 人 们 发 展 出 了 很 多 标准 来 评估 REST。 


3.6 API 衡量 和 分 类 


理 查 德 森 在 2008 年 (http://www.crummy.com/writing/speaking/2008-QCon/act3.html) 提出 
的 理 查 德 森 成 熟 度 模型 (http://martinfowler.com/articles/richardsonMaturityModel.html) 表 
达 了 一 种 连续 性 : 服务 可 借 由 REST 标准 来 评估 。 
































级 别 服务 描述 
0 级 HTTP HTTP 作为 一 种 远程 交互 的 传输 系统 【远程 过 程 调用 ) 
1 级 资源 不 将 所 有 请 求 发 送 至 单一 的 服务 ， 而 是 引用 不 同 的 资源 








2 级 HTTP 方 法 ”利用 HTTP 动词 














Jan Algermissen 基于 REST 约束 ( 详 见 表 3-4)， 也 提出 了 类 似 的 分 类 来 描述 API。 


表 3-4: 对 基于 HTTP 的 API 分 类 ， 源 自 Jan Algermissen (http:/nordsc.com/ext/classification_ 
of _http_based_apis.html) 


名 称 动词 ”一般 媒 体 类 型 ”特殊 媒体 类 型 HATEOAS 
WS-* web services (SOAP) N N N N 
RPC URI-tunneling Y N N N 
HTTP-based Type I Y Y N N 
HTTP-based Type II Y Y Y N 
REST Y Y Y Y 


两 种 分 类 系统 都 保留 了 菲 尔 丁 对 REST 严格 的 定义 ， 同 时 也 兼顾 了 实现 Web API 时 必要 的 
妥协 。 


3.7 ”函数 式 编程 和 和 REST 


函数 式 编 程 和 REST 有 很 多 共性 。 从 本 质 上 来 说 ， 两 者 都 是 声明 式 的 ， 几 乎 没有 对 于 控制 
流程 的 描述 。 两 者 对 于 控制 副作用 的 观点 也 一 致 ， 维 护 了 引用 的 透明 性 ， 都 以 无 状态 的 方 
式 操作 。 拿 JavaScript 来 说 ， 如 果 对 国 数 式 编程 范式 有 清晰 的 理解 ， 会 为 高 效 使 用 REST 
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带 来 极 大 帮助 ， 也 有 助 于 理解 REST 的 优点 。 





Web 演算 的 Web 
除了 上 述 对 于 REST 和 函数 式 编程 从 实用 性 上 的 比较 ，Tyler Close 将 Web 视 为 lambda 
演算 的 一 种 变 体 (http:W/www.waterken.com/devw/Web/REST/) 。 由 于 函数 式 编 程 语言 基 
于 lambda 演算 ， 两 者 之 间 的 关联 比 看 上 去 更 加 密切 : 
认识 到 Web 是 以 HTTP 操作 的 资源 ， 揭 示 了 WWW 其 实 是 lambda 演算 的 
一 种 变 体 。 资 源 就 是 闭 包 ，POST 方法 是 “apply” 操 作 。 由 资源 组 成 的 Web 
其 实 就 是 一 个 闭 包 网 络 。WWW 的 创新 在 于 对 闭 包 网 络 的 反思 ， 即 GET 方 
法 ……: 将 HTTP 理解 成 lambda 演算 的 一 种 变 体 ， 让 使 用 HTTP 作为 分 布 式 
计算 的 基础 ， 而 不 仅仅 是 分 布 式 超 媒 体 成 为 可 能 








在 Programming Scala (http:/shop.oreilly.com/producUy9780596155964.do，O"Reilly 出 版 ) 一 
书 中 ， 作 者 Wampler 和 Payne 指出 ， 很 多 情况 下 ， 面 向 对 象 系统 并 不 能 总 现 其 组 件 复 用 的 
承诺 。 相 反 ， 成 功 的 组 件 模型 其 实 很 简单 。 他 们 对 这 种 相对 简单 的 方式 反复 重申 ， 在 章节 
末尾 对 函数 式 编程 做 了 总 结 : 




















组 件 之 间 应 该 通过 交换 不 可 变 的 数据 结构 交互 ， 比 如 列表 和 散 列 表 ， 它 们 同时 扒 
有 数据 和 命令 。 这 种 组 件 模型 足够 简单 ， 也 足够 丰富 ， 能 应 付 真正 的 工作 。 注 
意 ， 这 看 起 来 多 么 像 HTTP 和 REST 啊 ! 


3.8 项 目 


下 面 的 项 目 创建 了 一 个 最 简化 的 API， 能 响应 GET、POST、UPDATE 和 DELETE 请 
求 ， 将 处 理 结果 返回 给 客户 端 。 该 项 目 还 展示 了 测试 REST 和 其 他 Web API 时 用 到 的 
各 种 工具 。 


创建 该 项 目 ， 需 做 如 下 准备 。 






































(1) 从 GitHub 下 载 项 目 代 码 (https://github.com/java-javascript/client-server-web-apps/tree/ 
master/Chapter-3-REST-and-JSON/jruby-sinatra-rest) 。 

(2) 切换 到 jruby-sinatra-rest 目录 。 

(3) 连接 上 因特网 ， 使 用 如 下 命令 构建 项 目 : 


$ mvn clean install 


该 命令 会 下 载 项 目 所 需 的 Ruby 和 Java 资源 。 构 建成 功 后 ， 会 看 到 如 下 信息 : 








[ENEOT sa 作 相 仆人 什 人 仆人 和 人 全 仙人 信人 仆仆 和 人 
[INFO] BUILD SUCCESSFUL 

EINEO] SS 
[INFO] Total time: 32 seconds 

[INFO] Finished at: Tue Apr 30 12:59:15 EDT 2013 

[INFO] Final Memory: 13M/1019M 

[ENE OT en 克 生 三 避 区 症 和 贡 全 有 训 区 全 和 交大 总 


(4) 启动 服务 器 : 
$ mvn test -Pserver 
几 秒 钟 后 ， 应 用 服务 器 启动 成 功 ， 准 备 好 接受 请 求 : 


== Sinatra/1.3.1 has taken the stage on 4579 for development... 
[2013-04-30 13:00:24] INFO WEBrick::HTTPServer#start: pid=29937 port=4579 


(5) 在 浏览 器 地 址 栏 输入 http://localhost:4579/about。 
接 下 来 会 得 到 如 下 响应 : 
{ 


"ruby.platform": "java", 
"ruby.version": "1.8.7", 
"java.millis": 1367342095907 


} 


这 表明 JRuby 已 经 就 位 ， 需 要 的 RubyGems (软件 包 ) 也 已 经 就 位 ，Java (系统 ) 可 以 
成 功 调用 。 


现在 服务 器 已 经 运行 起 来 ， 你 可 以 选择 一 个 客户 端 来 测试 REST 调用 。 下 面 的 一 些 例子 使 
用 了 Curl (http://curl.haxx.se/)。Curl 是 一 个 命令 行 工具 ， 通 过 访问 URL 传输 数据 。 它 可 
以 和 包括 HTTP 在 内 的 很 多 协议 工作 ， 能 处 理 很 多 通常 在 浏览 器 里 完成 的 任务 。 



































让 我 们 开始 吧 ， 可 对 任意 URL 调用 GET。 以 我 们 的 服务 器 为 例 ， 返 回 结果 是 关于 请 求 的 


信息 : 





oo 


$ curl http://LocaLhost:4579/about 


{ 
"ruby.platform": "java", 
"ruby.version": "1.8.7", 
"java.millis": 1367342095907 
} 

















Curl 有 大 量 选 项 来 改变 命令 行为 和 返回 名 在 传统 浏览 器 里 ， 一 般 不 显示 HTTP 头 信 
息 。 使 用 -i (包含 HITP 头 ) 或 -I (只 包含 HTTP 头 ) 在 响应 中 显示 HTTP 头 信息 : 


马 
Ey 
涝 








$ curl -ir http://localhost:4579/about 
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服务 器 端 很 简单 ， 它 由 Ruby 编写 (因此 运行 在 JRuby 之 上 )。 程 序 用 到 了 一 个 Sinatra 
(http://www.sinatrarb.com/intro.html) 的 微 框 架 ， 该 框架 被 形容 为 “一 门 使 用 Ruby 快速 创 
建 Web 应 用 的 DSL”*。 就 像 所 说 的 那样 ， 它 不 需要 有 可 能 混淆 功能 的 大 量 额 外 代码 和 结 
构 ， 就 可 以 创建 服务 器 ， 通 过 HTTP 对 外 提供 服务 。 











前 面 几 行 描述 了 需要 引入 的 包 和 一 些 配 置 。 然 后 , “before” 部 分 定义 了 before 过 滤器 。 
在 所 有 情况 下 ， 内 容 类 型 都 指定 为 JSON， 从 发 来 的 请 求 里 提取 一 些 值 赋 给 响应 ， 响 应 
代码 要 么 为 200， 要 么 是 传 入 的 请 求 参数 httpErrorCode 的 值 。 使 用 -i 选项 查看 响应 和 
HTTP 头 : 





| 








$ curl -i http://Llocalhost:4579/?httpErrorCode=400 


该 例子 如 在 参数 中 指定 的 那样 ， 返 回 HTTP 400 (Bad Request) : 





HTTP/1.1 400 Bad Request 

Content-Type: application/json;charset=utf-8 
Content-Length: 197 

X-Content-Type-Options: nosniff 

Server: WEBrick/1.3.1 (Ruby/1.8.7/2011-07-07) 
Date: Tue, 30 Apr 2013 17:43:17 GMT 
Connection: Keep-Alive 


使 用 POST 或 PUT JSON 的 例子 如 下 所 示 : 


$ curl -i -H "Accept: application/json" -X POST -d "['test',1,2]" \ 
http://localhost:4579 


$ curl -i -H "Accept: application/json" -X PUT -d "{phone: 1-800-999-9999}" \ 
http://LocaLhost:4579 





本 


下 是 DELETE 的 例子 : 











$ curl -i -H "Accept: application/json" -X DELETE http://LocaLhost:4579 














服务 器 能 处 理 任意 路 径 (使 用 通配符 匹配 )， 因 此 可 传 入 任意 路 径 和 查询 参数 ， 然 后 在 响 
应 中 显示 : 

















curl -i -H "Accept: application/json" -X POST -d "['test',1,2]" \ 
http://Llocalhost:4579/customer?filter=current 
HTTP/1.1 200 OK 


还 有 一 些 浏览 器 插件 也 能 用 来 测试 REST 调用 。 在 这 里 ， 我 们 不 介绍 这 些 插件 ， 而 是 使 用 


应 用 中 自 带 的 、 我 们 自己 用 jQuery 编写 的 一 个 简化 REST 客户 端 。 前 面 使 用 Curl 描述 过 
的 调用 ， 在 http://localhost:4579/testrest.html 输入 参数 后 ， 如 图 3-1 所 示 。 























在 Chrome 浏览 器 的 开发 者 工具 的 网 络 一 栏 中 ， 可 以 查看 头 信 息 和 响应 代码 。 
了 修改 上 一 次 调用 返回 401 的 样子 。 


| 








3-2 展示 

















| 大 
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eoe ) DD Test Web API x 下 [3 
Lan/ ~ 一 





€ SC 门 Ilocalhost4579/testrest.html 空 


Angularls: APIRefer 门 jQuerify [] postto News.YC 柄 OReilly Atlas - Builc [] client ServerWebs 


Web API Test 


URL 
http://localhost:4579/custome 





HTTP Verb 
POST 


4 


Request Body Data (JSON) 
[test',1,2] 
Error Code 


| Make Call 





"request.url": "http://localhost:4579/customer?filter=current", 
"request.request_method": "POST", 

"request .query_string" filter=current", 
"request.media_type": "application/x-ww-form-urlencoded", 
"request.body": "['test',1,2]" 








图 3-1; 测试 REST 


























了 加 
@ee ) DD Test Web API x We 这 
€ SC [0 localhost:4579/testrest.html 站 三 
WO AngularJs: API Refe DjQuerify [postto News.YC 区 OReilly Atlas -Built 门 Client ServerWebs 

URL 
http://localhost:4579/custome 
HTTP Verb 

POST 
Request Body Data (JSON) 
[test',1,2] 

Error Code 

401 

| Make Call 

网。 Elements Resources | Network | Sources Timeline Profiles Audits Console Angularls 
Name Status Size Time 
Path Method Text Type Initiator Content | Latency Timeline i Ee 
国 customer?filter=current&httpErrorCode=401 posT 401 [本 jquery.min.js:6 。 5178 386ms 

Unauthorized’ | apPIeatonjjson | Gcripe 279B 377ms 





®@ © © | pocuments Stylesheets Images Scripts XHR Fonts WebSockets Other 8@3 并 











图 3-2: 测试 REST 错误 
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这 个 简单 的 应 用 还 介绍 了 如 何 通 过 儿 行 代码 ， 就 能 搭建 起 Web API 作为 后 台 供 客户 端 开 发 
者 使 用 ， 这 样 就 能 和 服务 器 端 开发 者 一 起 并 行 工 作 ， 实 现 服务 器 的 完整 功能 。 下 面 是 对 这 
几 行 代码 的 简略 一 览 : 





$ cd jruby-sinatra-rest/src/main 
$ find scripts -name *.* | xargs cat | wc -lL 
141 


这 不 包括 由 内 容 分 发 网 络 (CDN) 提供 的 jQuery 和 bootstrap ， 但 仍然 展示 了 几 行 代码 带 来 
的 无 限 可 能 。 


3.9 其 他 Web API 工 具 


Web API 不 同 任何 平台 绑 定 ， 因 此 ， 选 用 什么 样 的 工具 调试 更 多 出 于 开发 者 的 个 人 喜好 。 
正如 展示 的 那样 ， 浏 览 器 和 浏览 器 插件 非常 有 用 ， 而 Curl 提供 了 一 种 灵活 的 命令 行 选 择 。 
基于 Java 的 Web 客户 端 (https://code.google.com/p/rest-client/)、REST 框架 (http://restlet. 
com/) 和 Eclipse IDE 插件 (http://wwl.ywebb.com/) 深 受 Java 社 区 的 喜爱 ， 而 Fiddler 
(http://www.telerik.com/fiddler) 则 是 微软 拥 盈 的 人 气 选 择 。 


3.10 约束 回顾 


天 才 们 完全 抛弃 外 界 影响 的 想法 是 不 切实 际 的 。 这 种 方式 在 软件 开发 领域 行 不 通 ， 与 艺术 
领域 里 取得 的 那些 伟大 成 就 也 没 多 大 关系 。 相 反 ， 认 清 约束 并 且 创 造 性 地 加 以 应 用 是 一 种 
更 为 可 行 的 方式 。《 纽 约 时 报 》 曾 撰文 (http://www.nytimes.com/learning/general/onthisday/ 
bday/0617.html) 将 作曲 家 伊 戈 尔 .斯 特 拉 文 斯 基 形 容 为 从 作曲 伊始 就 明确 限制 ， 以 “获取 
执行 时 的 精准 ”: 












































对 斯 特 拉 文 斯 基 来 说 ， 作 曲 就 是 解决 音乐 问题 的 过 程 : 在 他 开始 工作 之 前 ， 就 将 
这 些 问题 定义 出 来 。 

比如 ， 在 谱写 “ 众 神 领袖 阿波 罗 ” 时 ， 他 写 信 给 负责 该 芭蕾 狂 剧 的 伊丽莎白 "斯 
普 拉 格 。 库 利 奇 ， 询 问 演出 时 舞台 的 大 小 、 大 厅 有 多 少 座位 ， 甚 至 管弦 乐队 面向 
什么 方向 。 


“限制 越 多 越 自由 "， 他 曾经 如 是 言 ,“ 限 制 的 任意 性 ， 实 质 上 是 为 获取 执行 时 的 
精准 度 服 务 的 。 


一 一 《纽约 时 报 》 





REST 和 JSON 带 来 的 约束 远 非 任意 ， 但 是 它们 的 确 为 客户 端 - 服 务 器 端 Web 应 用 的 开发 
带 来 了 执行 上 的 精度 。 
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“编程 语言 最 初 的 作用 是 充当 人 类 和 计算 机 之 间 交 流 的 媒介 。 现 在 ， 软 件 的 生命 
周期 延长 了 ， 编 程 团队 也 壮大 了 。 因 为 程序 员 需 要 讨论 软件 ， 代 码 也 就 成 了 人 与 
人 之 间 交 流 的 重要 媒介 。” 

一 一 吉 勒 斯 * 杜 博 切 特 


在 这 段 话 里 ， 吉 勒 斯 . 杜 博 切 特 (Gilles Dubochet) 在 分 析 编 程 语言 在 人 类 交流 中 扮演 的 角 
色 时 ,介绍 了 人 “分布 式 认 知 "。 人 们 常常 抽象 地 研究 编程 语言 ， 却 忽略 了 一 些 显 而 易 见 的 
环境 因素 。 


。 编程 从 来 不 是 一 项 孤立 的 活动 。 现 在 很 多 项 目 都 需要 庞大 的 分 布 式 团队 。 

。 计算 机 语言 是 程序 员 与 程序 员 之 间 交 流 的 重要 媒介 。 

。 程序 员 用 文字 描述 代码 质量 ， 明 示 或 暗示 着 期 望 代码 在 同事 之 间 是 可 读 的 。 

。 紧凑 的 代码 能 在 达成 共识 的 程序 员 之 间 提 高 “代码 的 可 理解 性 ”。 

。 程序 员 没 办 法 将 大 型 系统 的 所 有 需求 都 存在 自己 〈 人 类 ) 的 记忆 里 。 

。 人 工 可 读 的 文档 (如 果 有 的 话 ) 常常 不 能 和 系统 保持 同步 。 

。 文档 不 是 总 能 够 描述 软件 的 每 一 个 边界 情况 。 信 息 隐 藏 在 代码 中 。 

本 章 提 到 了 各 种 能 运行 在 Java 平台 上 的 编程 语言 ， 这 使 为 某 项 特定 的 任务 或 特殊 人 群 挑选 
最 佳 编程 语言 成 为 可 能 。 本 章 还 讲解 了 Maven， 作 为 一 种 工具 ， 它 在 团队 编程 时 提供 了 很 
多 最 佳 实践 。 












































4.1 _ Java 语言 
Java 是 一 种 成 熟 、 稳 定 ， 并 广为人知 的 语言 ， 但 挑战 依然 存在 ， 在 某 些 地 方 ， 这 种 基于 
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类 、 融 态 类 型 和 面向 对 象 的 语言 用 起 来 很 麻烦 。 技 术 可 能 会 彼此 不 搭 ， 一 开始 就 考虑 禁 代 
方案 可 能 有 助 于 弥合 分 歧 。 





开发 者 熟悉 将 一 门面 向 对 象 的 语言 (比如 Java) 和 关系 型 数据 库 集 成 起 来 的 挑战 ， 而 这 


是 很 小 的 一 个 例子 。 虽 然 一 些 矛 盾 能 通过 改变 使 用 习 ; 








也 


pa 


AAA 





将 化 解 ， 但 总 会 引入 一 个 映射 层 ， 


[ey 


是 由 面向 对 象 和 关系 型 模型 所 秉持 的 基本 哲学 之 间 的 不 同 造成 的 。 





这 并 不 是 Java 所 特有 的 ，JSON 和 REST 之 间 也 存在 这 种 矛盾 。REST 要 求 链接 需 满足 


HATEOAS 中 统一 接口 的 约束 。 JSON 作为 JavaScript 语言 的 子 集 ， 二 


F 没 有 与 之 对 应 的 结 





构 。 不 能 说 谁 对 谁 错 ， 它 们 的 起 因 不 同 ， 集 成 到 一 起 时 就 会 产生 不 协调 的 情况 。 





同样 的 矛盾 在 本 
REST 中 ， 资 源 是 由 它 的 表示 操作 的 。 这 层 额 外 的 和 
源 ， 这 不 是 一 个 对 象 系统 中 缺 省 就 有 的 功能 。 

















i 向 对 象 和 REST 之 间 也 有 。 在 面向 对 象 系统 中 ， 操 作 的 是 对 象 本 身 。 在 
由 象 让 人 们 能 以 一 个 共同 的 接口 访问 资 





Java 开发 者 发 明了 很 多 类 库 来 解决 大 多 数 翻译 和 与 其 他 技术 集成 的 问题 。 此 外 ，Java 虚拟 





机 (JVM) 作为 Java 平台 有 


4.2 ”Java 虚拟 机 


Java 被 翻译 成 字 节 码 在 JVM 上 执行 ( 见 图 


的 一 个 组 介 








F， 本 身 就 为 使 用 其 他 语言 提供 














了 可 能 。 





4-1)。Java 一 开始 就 被 设计 成 跨 平台 的 语言 ， 


因此 为 不 同 平台 ， 从 高 性 能 服务 器 到 嵌入 式 设备 ， 都 开发 定制 了 JVM。 





Java 源 代码 
(java 扩 展 名 ) 
(javac) 
Java 字 节 码 
《class 文 件 扩展 名 ) 
Java 虚 拟 机 












Java 庶 拟 机 








Java 虚 拟 机 








4-1: Java 编译 流程 
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JVM 对 Java 语言 的 相对 独立 性 启示 人 们 开发 出 了 其 他 运行 在 JVM (http://www. 
oraclejavamagazine-digital.com/javamagazine/20120102?pg=66&search_term=saternos&doc_ 
id=-1&search_term=saternos#pg66) 之 上 的 语言 ,包括 Ruby (前 一 章 介 绍 的 JRuby)、 
Python (Jython)、Groovy、Clojure 和 JavaScript。 以 前 人 们 只 把 JVM 当 作 安装 语言 的 一 部 
分 ， 提 供 了 跨 平台 开发 的 能 力 ， 现 在 它 变 成 了 实现 其 他 语言 的 接口 ( 见 图 4-2)。 


Python 脚本 JavaScript 
(.py) (js) 




























Java 编 译 器 
(javac) 
Java 字 节 码 
.class 文 件 扩 展 名 ) 
Java 虚 拟 机 







Java 虚 拟 机 


JVM 脚本 语言 接口 和 对 静态 类 型 语言 的 支持 


图 4-2 所 示 的 语言 在 本 章 稍 后 的 项 目 和 书 中 其 他 部 分 都 会 用 到 。 从 众多 JVM 
支持 的 语言 中 选中 它们 ， 是 因为 知道 它们 的 人 相对 更 多 ， 而 且 在 JSR 223: 
Scripting for the Java Platform (https:/www.jcp.org/en/jsr/detail?id=223) 定义 
的 脚本 接口 中 能 使 用 。 脚 本 接口 为 在 一 个 项 目 中 集成 多 种 JVM 支持 的 语言 
提供 了 统一 的 机 制 。 其 中 几 种 语言 还 受到 了 JSR 292: Supporting Dynamically 
Typed Languages on the Java Platform (https://jcp.org/en/jsr/detail?id=292) 后 
续 工 作 的 影响 ， 因 此 正在 加 紧 开 发 和 改进 ， 以 适应 JVM。 


Java 虚 拟 机 

















4-2: JVM 语言 的 编译 流程 



















































































有 了 这 些 相对 简洁 和 强大 的 脚本 语言 ， 在 创建 运行 在 JVM 之 上 的 API 时， 就 可 以 拿 来 替 
代 Java。 本 章 稍 后 提 到 的 项 目 将 展示 如 何 使 用 各 种 JVM 语言 操作 JSON。 


4.3 Java 工 具 


Java 是 一 门 成 熟 的 语言 ， 有 很 多 标准 的 IDE 可 供 选 择 ， 包 括 Eclipse (http://www.eclipse. 
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org/home/index.php)、 NetBeans (https://netbeans.org/) 和 IntelliJ (http://www.jetbrains.com/ 
idea/)。 这 些 IDE 都 带 有 开发 工具 和 插件 ， 把 程序 员 从 编写 代码 、 调 试 、 分 析 和 大 量 其 他 
琐碎 乏味 的 工作 中 解脱 出 来 。IDE 在 开发 者 工作 中 占有 重要 位 置 ， 掌 握 它 是 现代 Java 开发 
中 一 项 必 不 可 少 的 技能 。IDE 还 提供 了 和 其 他 系统 的 集成 ， 比 如 版 本 控制 和 构建 自动 化 ， 
这 在 团队 项 目 中 非常 重要 。 


可 用 来 构建 项 目的 工具 有 很 多 。 长 期 以 来 ，Apache Ant (https://ant.apache.org/) 都 是 Java 
社区 的 最 爱 。Maven (http://maven.apache.org/index.html) 不 仅仅 定义 构建 流程 ， 还 引入 一 
些 广 为 接 受 的 软件 开发 任务 。Gradle (http:Wwww.gradle.org/) 是 个 基于 Groovy 语言 的 后 
起 之 秀 。Ant 和 Maven 都 基于 XML， 而 Gradle 是 一 门 完整 的 领域 专用 语言 (DSL)。 























除去 一 定 程度 上 的 复杂 性 ， 还 要 有 额外 的 架构 指导 开发 流程 。 项 目 不 同 ， 架 构 也 有 所 不 
同 ， 但 遵循 那些 被 充分 理解 和 建立 的 编程 实践 ， 就 能 缩短 适应 期 ， 在 最 低 限度 影响 程序 员 
效率 的 情况 下 让 项 目 变 得 可 控 。 简 单 地 说 ， 这 种 架构 能 让 项 目 组 扩展 成 为 可 能 。 


4.4 构建 工具 


项 目 启 动 时 ， 应 该 将 什么 东西 包括 进来 ， 是 架构 师 或 开发 负责 人 要 做 出 的 最 重要 决定 之 
一 。 这 个 决定 影响 到 后 续 开发 ， 当 项 目 稳定 后 想 要 改变 就 很 难 了 。 构 建 系统 的 选择 会 对 后 
续 活 动产 生 巨 大 影响 ， 选 择 时 要 考虑 以 下 儿 点 。 


编程 工具 语法 提供 的 灵活 性 非常 有 用 。 马 丁 . 福 勒 (马丁 * 福 勒 ，http://martinfowler.com/ 
articles/rake.html) 曾经 对 比 过 make (https://www.gnu.org/software/make， 它 有 为 自己 定制 
的 语法 )、ant (http://ant.apache.org/， 它 的 语法 基于 XML) 和 rake (http://rake.rubyforge. 
org/， 它 使 用 了 Ruby 编程 语言 )， 以 此 引起 人 们 对 构建 脚本 应 该 拥有 一 门 完整 功能 的 编程 
语言 的 重视 。 近 年 来 ， 另 外 一 个 更 能 引发 人 们 兴趣 的 因素 可 能 就 是 构建 工具 的 依赖 管理 。 
没有 依赖 管理 ， 开 发 者 就 必须 确认 、 定 位 、 下 载 和 安装 依赖 的 模块 和 相关 资源 (有 时 文档 
还 有 限 )。 能 自动 管理 在 线 代 码 库 里 特定 版 本 的 模块 ， 对 每 个 开发 者 来 说 价值 连城 ， 也 会 
让 项 目 更 加 稳定 。 请 看 表 4-1。 


表 4-1: 构建 工具 的 比较 





















































定制 的 DSL XML DSL 编程 语言 依赖 管理 
make (https:/www.gnu.org/software/make) Y N N 
ant (http://ant.apache.org/ ) N Y N 
rake (http://rake.rubyforge.org/) N N Ruby N 
Maven (http://maven.apache.org/) N Y 注 
Gradle (http:/www.gradle.org/) N N Groovy Y 
SBT (http:/www.scala-sbt.org/) N N Scala Y 























这 种 比较 有 点 过 于 简单 化 ， 因 为 构建 工具 都 有 很 好 的 扩展 性 。 如 果 构 建 工 具 本 身 不 支持 ， 
可 以 将 依赖 管理 做 成 加 载 项 ， 也 可 以 让 构建 工具 支持 其 他 编程 语言 以 扩展 其 能 力 。 比 如 ， 
使 用 Ivy (http://ant.apache.org/ivy/)， 就 能 让 Ant 支持 依赖 管理 ， 还 有 一 个 Groovy 版 的 
Ant， 叫 作 Gant (http://gant.codehaus.org/)。 

















表 4-1 列 出 了 被 广泛 使 用 的 构建 工具 ， 但 是 并 没有 列 出 全 部 。 从 1977 年 开始 ，Make 就 或 多 
或 少 影响 了 大 多 数 构建 工具 (包括 Rake)。Rake 又 启发 了 几 个 面向 Java 的 项 目 ， 包 括 Raven 
(http://raven.rubyforge.org/) 和 Apache buildr (http://en.wikipedia.org/wiki/Apache_Buildr)。 

















无 论 项 目 大 小 ， 依 赖 管理 都 是 之 无 疑问 的 优秀 功能 。 一 门 完整 的 编程 语言 能 提供 很 多 灵 
活性 。Ruby 曾经 是 一 个 很 受 欢迎 的 选择 ， 但 现在 很 多 方面 已 经 被 Groovy 超越 了 ， 因 为 
Groovy 太 像 Java 了 (就 像 前 面 提 到 的 ， 一 个 合法 的 Groovy 文件 也 是 一 个 合法 的 Java 文 
件 )。 因 此 Gradle 现在 开始 成 为 更 受 欢 迎 的 选择 ， 它 包含 依赖 管理 功能 ， 支 持 一 门 完整 的 
脚本 语言 ， 该 语言 语法 简练 ， 易 于 被 Java 开发 者 掌握 。 类 似 地 ，Scala 用 户 有 SBT (Scala 
Build Tool，http://www.scala-sbt.org/)， 它 的 设计 和 目的 与 Gradle (Gradle 是 Groovy 的 构 
建 工具 ) 类 似 。 除 了 Scala 中 使 用 SBT，Play 框架 也 使 用 了 SBT，Play 框架 同时 支持 Scala 
和 Java。 





尽管 选择 很 多 ， 灵 活性 常常 是 有 益 的 ， 使 用 一 个 “自以为是 ”的 工具 ， 基 于 最 佳 实践 预先 
做 出 一 些 决 策 能 带 来 很 大 的 益处 。Maven 就 是 这 种 方式 的 杰出 代表 。 














需要 少 一 点 灵活 性 吗 ? 

马丁 " 福 勒 的 文章 强调 了 构建 脚本 支持 一 门 完整 的 编程 语言 带 来 的 灵活 性 。 其 优点 包 
括 更 少 的 重复 代码 ， 没 有 舍弃 DSL 去 做 一 些 “ 有 趣 的 事 ” 所 带 来 的 挫折 感 。 他 的 焦点 
在 搭建 自己 的 网 站 上 (一 个 庞大 的 个 人 网 站 ) 。 然 而 ， 当 更 多 人 参与 其 中 时 ， 更 多 控制 
和 规范 (意味 着 更 少 的 灵活 性 ) 也 是 有 蔓 的 。 标 准 的 命名 规范 和 熟知 的 构建 顺序 会 减 
少 项 目 局 动 后 ， 陆 续 加 入 的 开发 者 的 困惑 (这 在 大 型 的 开源 项 目 和 按 需 将 程序 员 分 配 
到 不 同 项 目 组 的 公司 中 很 常见 ) 。 当 蹦 出 一 个 要 在 构建 系统 中 实现 一 个 非 同 寻常 的 任务 
的 念头 时 ， 系 统 会 让 整个 事情 变 慢 ， 做 决定 的 难度 更 大 ， 以 避免 做 出 草率 的 决定 。 这 
就 迫使 开发 困 队 停 下 来 问 自 己 “ 我 们 真 的 要 这 样 做 吗 ” 以 及 “我 们 究竟 想 要 达到 什么 
目的 ”。 


一 个 倾向 于 灵活 性 的 系统 (比如 Gradle) 便于 任意 调用 任务 (和 简单 的 标准 构建 相 
反 )。 在 一 个 相对 较 小 、 较 稳定 的 团队 里 ， 交 流 起 来 很 顺畅 ， 架 构 很 清晰 ， 并 且 喜 欢 
掌控 的 感觉 ， 这 种 系统 就 能 极 大 提升 生产 效率 。 在 大 一 点 的 团队 中 ， 更 倾向 于 标准 和 
规范 ， 因 为 你 无 需 问 “该 使 用 什么 命令 构建 系统 ?我们 有 各 种 各 样 的 任务 : compile 
install、 build、make、package*………: 到 底 该 用 哪个 ? ”这 样 的 问题 ， 就 能 检 出 代码 构建 
项 目 。Maven 强制 程序 员 遵 循 标准 和 规范 ， 这 样 做 节省 了 时 间 和 交流 的 开销 ， 让 灵活 
性 得 以 存在 于 大 的 团队 中 。 
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Maven (http://maven.apache.org/， 这 个 词 在 犹太 语 中 的 意思 是 “知识 渊博 的 人 ”) 用 来 组 织 
项 目 ， 并 且 定 义 软 件 开发 流程 。 人 们 称 它 为 “软件 项 目 管理 和 理解 的 工具 ”。 它 简化 了 构 
建 流程 ， 提 供 了 创建 项 目的 统一 系统 (通过 声明 项 目 依 赖 的 方式 )。 它 的 报告 和 文档 功能 
负责 生产 和 集中 管理 所 有 项 目 相关 的 技术 产 出 。 


Maven 有 一 些 重 要 的 特性 : 














。 提倡 约定 重 于 配置 (同时 保留 了 可 扩展 性 和 可 定制 性 ) ; 
。 对 所 有 项 目的 接口 都 是 一 致 的 ， 

。 提供 了 一 套 定义 完好 的 构建 生命 周期 ， 

。 基于 项 目 对 象 模型 (pom.xml) 定义 了 通用 的 项 目 配置 。 











想 了 解 跟 多 关于 Maven 的 信息 ， 请 阅读 Maven: The Definitive Guide (http://shop.oreilly. 
com/product/9780596517335.do，O’Reilly 出 版 )， 本 书 还 可 免费 在 线 阅 读 (http:/blog. 
sonatype.com/2010/01/maven-the-definitive-guide-split-into-two-books/) 。 


4.4.1 Maven 的 优点 


即使 在 小 型 Java 项 目 中 ，Maven 的 价值 也 能 立即 体现 出 来 ， 因 为 Maven 允许 声明 式 地 确 
定 JAR 文件 。 作 为 构建 流程 的 一 部 分 ，Maven 在 线 上 仓库 里 找到 这 些 JAR， 连 同 它们 的 依 
赖 一 起 下 载 到 本 地 仓库 中 的 合适 位 置 。 它 负责 指定 需要 的 CLASSPATH， 所 有 初始 构建 一 
个 项 目 需 要 的 基本 设置 在 一 条 命令 里 就 完成 了 。 光 凭 这 条 ， 就 足以 在 构建 最 小 的 项 目 时 孝 
虑 使 用 Maven 了 ， 但 是 它 的 优点 不 止 于 此 。 




















随 着 项 目的 进展 和 正规 化 ， 单 元 测试 、 生 成 的 文档 和 构建 报告 都 会 被 组 装 和 保存 到 标准 的 
位 置 。 项 目 有 了 标准 化 的 结构 和 约定 ， 让 新 的 开发 人 员 上 手 更 容易 。 这 对 很 多 项 目 来 说 都 
是 大 有 神 益 的 ， 从 开源 项 目 到 大 的 组 织 机 构 ， 那 里 的 开发 人 员 会 因为 人 力 资源 的 变化 在 各 
项 目 间 转 换 。 








结构 民 好 的 项 目 特别 适合 开发 和 部 署 复 杂项 目 。 使 用 Maven 构建 的 项 目 可 以 方便 地 持续 集 
成 (CI，http://maven.apache.org/continuous-integration.html)。 利 用 和 版 本 控制 系统 的 关联 ， 
使 用 标签 和 不 断 上 升 的 版 本 号 让 发 布 管理 变 得 可 控 和 标准 化 。 事 实 上 ， 如 果 系 统 包 含 了 一 
组 健全 的 测试 ， 能 经 常 在 CI 服务 器 运行 ， 并 且 生 产 环境 里 拥有 足够 的 管理 和 提醒 功能 ， 
就 有 可 能 经 常 将 一 些 版 本 持续 部 署 (http://radar.oreilly.com/2009/03/continuous-deployment- 
5-eas.html)。 项 目 初期 形成 的 合理 结构 为 开发 人 员 带 来 的 优势 立竿见影 ， 省 去 了 从 开发 到 
部 署 的 很 多 工作 。 





















































4.4.2 Maven 的 功能 
Maven 本 身 很 简单 ， 也 没有 提供 太 多 功能 。 通 过 使 用 插件 ，Maven 能 执行 大 量 的 标准 构建 














54 | 第 4 章 


邮 


任务 ， 并 能 被 以 你 能 想像 得 到 的 任何 方式 扩展 。 这 里 有 一 些 例子 仅 供 参考 。 





。 使 用 JUnit (http://maven.apache.org/surefire/maven-surefire-plugin/examples/junit.html) 单元 


测试 ， 生 成 单元 济 








试 代码 覆盖 率 报告 (http://mojo.codehaus.org/cobertura-maven-plugin/)， 





这 些 都 是 新 建 项 目 时 的 标准 配置 ( 需 使 用 Maven 项 目 模板 archetypes)。 





。 可 以 使 用 mvn site 
目 目的 和 状态 的 项 








(http://maven.apache.org/guides/mini/guide-site.html) 创建 一 个 描述 项 
目 页 面 。 可 以 使 用 类 wiki 格式 的 APT (Almost Plain Text) 或 其 他 支 




















持 格 式 创建 一 个 Maven 页 面 。 这 个 页 面 统一 向 外 提供 了 项 目 信息 、 联 系 方式 .报告 和 资源 。 
。 在 开发 阶段 ， 使 用 一 行 简单 的 命令 : mvn jetty:run (http://docs.codehaus.org/display/ 
JETTY/Maven+jJetty+Plugin) ， 就 能 启动 一 个 最 小 化 配置 的 戏 入 式 应 用 服务 器 。 这 个 服 


务 器 也 可 以 作为 构 




















建 过 程 的 一 部 分 启动 ， 来 支持 单元 测试 。 还 有 其 他 的 插件 ， 可 以 将 





Web 应 用 部 署 到 你 选择 的 应 用 服务 器 上 。 
。 虽然 源 自 Java 社区 ， 人 们 还 编写 了 一 些 Maven 插件 支持 使 用 其 他 语言 开发 。JavaScript 





插件 (http://mojo.c 














odehaus.org/javascript-maven-tools/javascript-maven-plugin/) 提供 了 代 


码 组 织 服 务 和 单元 测试 。 还 有 提供 源码 压缩 (http://alchim.sourceforge.net/yuicompressor- 
maven-plugin/index.html) 和 控制 代码 质量 (http://mojo.codehaus.org/jslint-maven-plugin/) 


的 Maven 插件 。 


人 们 常常 形容 Maven 是 一 款 “ 有 主见 的 软件 ”。 从 负面 理解 ， 这 意味 着 Maven 很 难 适 应 
些 特 定 类 型 的 项 目 。 但 是 它 这 种 武断 的 特质 却 定义 了 一 个 即使 使 用 其 他 构建 系统 ， 也 值得 
考虑 的 良好 的 软件 开发 生命 周 斯 和 最 佳 实践 。 它 消除 了 依赖 个 人 记忆 和 手工 定义 合适 的 构 
建 流程 和 细 市 ， 使 用 标准 配置 的 项 目 管理 可 通过 大 量 插 件 来 增强 。 这 在 项 目 ， 其 至 一 个 组 
织 内 提倡 了 一 种 统一 的 实践 。 和 开放 的 系统 将 职责 推 给 开发 者 去 记忆 相 比 ，Maven 的 “ 主 
见 ” 让 一 般 开 发 者 根本 不 用 去 想 这 些 外 围 问题 ， 只 需要 做 正确 的 事 就 够 了 ， 毕 竞 那 些 错误 
的 选项 会 花费 额外 的 精力 。 






































在 一 个 项 目 中 ， 起 初 的 选择 对 后 续 开发 的 影响 极 大 ， 不 仅 对 组 成 项 目的 组 件 如 此 ， 对 开发 

















工具 和 构建 系统 同样 如 此 。 选 择 Maven 还 是 其 他 构建 工具 ， 这 对 后 续 活 动 影响 颇 大 。 本 章 
后 面 的 项 目 使 用 了 Maven， 这 是 为 了 展示 创建 一 个 包含 最 小 配置 的 项 目 是 多 么 简单 ， 同 时 
也 展示 了 声明 式 管 理 模块 的 价值 。 一 旦 项 目 使 用 Maven 构建 ， 集 成 新 的 插件 和 功能 就 变 得 























非常 简单 了 。 


4.4.3 ”版 本 控 


如 果 你 已 经 在 阅读 本 





制 


BB， 那 么 就 不 需 我 殉 言 使 用 版 本 控制 的 好 处 。 大 多 数 开发 机 构 都 需要 








维护 控制 他 们 的 软件 资产 ， 版 本 控制 系统 就 是 用 于 这 个 目的 的 。 如 果 仅 把 它 当 作 一 个 文件 
系统 的 备份 ， 就 会 错失 很 多 伟大 的 功能 。 这 些 功能 包括 查看 代码 的 变更 历史 、 对 比 不 同 版 
本 、 标 记 待 发 布 的 代码 (标签 )、 创 建 分 支 以 便 并 行 开发 代码 和 创建 缓存 的 。 
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版 本 控制 系统 (Version Control System) 是 开发 大 型 项 目 时 ， 多 组 开发 人 员 共 同 高 效 合作 
的 基础 。 当 多 名 开发 人 员 需 要 修改 同一 个 文件 时 ， 极 大 地 降低 了 解决 冲突 的 难度 。 使 用 
VCS 支持 遗留 项 目 非 常 简 单 ， 因 为 它 保存 了 历史 记录 ， 谁 改变 了 哪些 文件 ， 什 么 时 候 改 的 
都 一 目 了 然 。 如 果 提 交代 码 时 加 上 了 有 用 的 注释 ， 或 者 已 经 和 缺陷 管理 系统 进行 集成 ， 就 
能 知道 为 什么 会 有 这 样 的 改动 了 。 


个 人 开发 者 能 从 VCS 中 受益 ， 因 为 他 们 有 信心 去 实验 ， 反 正在 需要 时 可 以 恢复 到 上 一 个 “好 ” 
版 本 。 如 果 一 个 项 目 需要 持续 很 长 时 间 ，VCS 历史 可 以 展示 进度 ， 提 供 代码 变动 的 原因 。 















































Maven 项 目 (http://maven.apache.org/source-repository.html) 使 用 Git 和 Subversion 来 管理 
自己 的 代码 。 





4.4.4 单元 测试 

很 容易 使 用 Maven/Junit (针对 Java) 、node/Karma (针对 JavaScript) 或 其 他 语言 使 用 的 
测试 框架 将 单元 测试 纳入 项 目 之 中 。 还 有 Java 框架 支持 其 他 类 型 的 测试 。 可 使 用 JBehave 
(http:Wjbehave.org/) 做 行为 驱动 开发 (Behavior-Driven Development，BDD)， 它 提供 了 
Maven 插件 (http://jbehave.org/reference/stable/maven-goals.html) 可 供 选 择 。 还 可 以 使 
用 Selenium 插件 (http://www.seleniumhq.org/) 在 浏览 器 上 运行 自动 化 测试 (http:/mojo. 


codehaus.org/selenium-maven-plugin/) 。 


























单元 测试 遇 到 的 挑 成 之 一 是 将 代码 和 外 部 依赖 分 离 。 在 测试 时 ， 可 以 创建 一 个 对 象 代 替 
真实 的 对 象 。 有 很 多 这 样 的 对 象 可 供 使 用 。 马 丁 . 福 勒 (http://martinfowler.com/articles/ 
mocksArentStubs.html#TheDifferenceBetweenMocksAndStubs) 强调 了 虚设 对 象 、 虚 拟 对 象 、 
桩 和 模拟 对 象 。 测 试 中 使 用 多 少 模拟 对 象 因 人 而 异 ， 但 Mockito (https://code.google.com/p/ 
mockito) 和 JMock (http://jmock.org/) 这 样 的 项 目的 存在 ， 让 原本 很 难 或 无 法 编写 的 测试 
代码 变 得 很 容易 。 




















项 目 、 客 户 、 开 发 团队 和 可 用 资源 不 同 ， 适 用 的 测试 方式 也 不 同 。 无 论 做 何 选择 ，Maven 
都 让 包含 一 个 测试 框架 (http:/maven.apache.org/surefire/maven-surefire-plugin/examples/ 
inclusion-exclusion.html) 变 得 容易 。 正 如 前 面 指 出 的 ， 一 套 全 面 的 测试 让 很 多 开发 和 部 署 
方式 成 为 可 能 ， 如 果 没 有 这 样 的 验证 和 测试 覆盖 ， 这 就 是 完全 不 可 行 的 。 


4.5 ”处 理 JSON 的 Java 类 库 


有 很 多 Java 类 库 能 处 理 (解析 或 生成 ) JSON。 由 于 Java 的 基本 结构 是 Java 对 象 ， 使 用 
Java 编写 的 JSON 类 库 基 于 JSON 和 Java 对 象 之 间 的 映射 ， 提 供 了 从 对 象 到 JSON 的 序列 
化 和 反 序 列 化 的 方法 。Jackson (http://jackson.codehaus.org/) 和 Gson (https://code.google. 
com/p/google-gson) 是 两 种 常用 的 Java 类 库 ， 可 以 在 Java 对 象 和 JSON 之 间 做 转换 。 
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4.6 项目 


这 些 项 目 提供 了 最 小 化 的 项 目 对 象 模型 ， 以 展示 声明 式 管 理 模块 的 价值 。 一 旦 项 目 能 成 功 
在 Maven 上 构建 ， 增 加 新 的 插件 和 功能 就 变 得 很 简单 。 


每 个 项 目 均 可 在 根 目录 下 使 用 下 述 命令 构建 : 























mvn clean install 














电脑 必须 联网 ， 这 样 Maven 才能 定位 和 下 载 每 个 项 目 需要 的 模块 。 第 一 次 在 项 目 中 运行 该 
命令 时 ， 它 会 先 检查 本 地 仓库 (默认 在 “< 操作 系统 的 用 户主 目录 >/.m2/repository” 下 )。 
如 果 找 不 到 ， 会 查找 Maven 的 在 线 仓 库 并 下 载 至 本 地 ， 以 便 后 续 使 用 。 运 行 mvn ctean 命 
令 会 移 除 项 目下 的 资源 ， 但 是 不 会 影响 到 下 载 至 本 地 仓库 的 模块 。 














4.6.1 用 Java 处 理 JSON 
java_json (https://github.com/java-javascript/client-server-web-apps/tree/master/Chapter-4-Java- 
and-Tools/java_json) 项 目 展示 了 Maven、Jackson 和 JSON Java APIs 的 基本 用 法 。pom.xml 
需要 包含 JSON 和 Jackson， 如 下 所 示 : 





<?xml version="1.0" encoding="UTF-8"?> 
<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
<modelVersion>4.0.0</modelVersion> 


<groupId>JSON_Java</groupId> 
<artifactId>JSON_Java</artifactId> 
<packaging>jar</packaging> 
<version>1.0</version> 


<dependencies> 
<dependency> 
<groupId>com.google.code.gson</groupId> 
<artifactId>gson</artifactId> 
<version>2.2.3</version> 
<scope>compile</scope> 
</dependency> 
<dependency> 
<groupId>org.codehaus.jackson</groupId> 
<artifactId>jackson-mapper-asl</artifactId> 
<version>1.9.12</version> 
</dependency> 
</dependencies> 
<build> 
<plugins> 
<plugin> 
<groupId>org.codehaus.mojo</groupId> 
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<artifactId>exec-maven-plugin</artifactId> 
<version>1.2.1</version> 
</plugin> 
</plugins> 
</build> 
</project> 


该 项 目 对 象 模型 定义 了 该 项 目的 身份 (或 者 坐标 : groupId、artifactId 和 version) 和 打 
包 方式 (JAR)。 通 过 version 指定 了 Jackson 和 JSON 的 版 本 ， 还 有 一 个 插件 说 明了 主 函 
数 的 执行 方式 。 这 是 一 个 非常 简单 的 pom.xml， 展 示 了 用 Maven 管理 JAR 之 间 的 依赖 有 多 
简单 。 即 使 你 是 一 个 Maven 新 手 ， 也 不 会 对 此 望 而 生 旦 ， 而 那些 Maven 专家 则 可 以 在 此 
基础 之 上 增加 单元 测试 、 文 档 、 报 告 和 所 有 喜欢 的 花哨 功能 。 














Java 代码 由 3 个 类 组 成 。 定 义 了 一 个 普通 Java 对 象 (POJO) 来 序列 化 和 反 序 列 化 JSON: 











package com.saternos.json; 


public class MyPojo { 
private String thingl; 
private String thing2; 


public MyPojo(){ 
System.out.println("*** Constructor MyPojo() called"); 


} 
public String getThing1() { 
return thing1; 


中 


public void setThing1(String thing1) { 
this.thing1 = thing1; 
} 


public String getThing2() { 
return thing2; 


} 


public void setThing2(String thing2) { 
this.thing2 = thing2; 


} 

@Override 

public boolean equals(Object o) { 
if (this == 0) return true; 


if (o == null || getClass() != o.getCLass()) return false; 
MyPojo myPojo = (MyPojo) o; 


if (thing1 != nuLL ? !thingi.equals(myPojo.thing1) : myPojo.thing1 != null) 
return false; 

if (thing2 != nuLL ? !thing2.equals(myPojo.thing2) : myPojo.thing2 != null) 
return false; 





return true; 


} 


@Override 
public int hashCode() { 
int result = thing1 != nuLL ? thingi.hashCode() : 0 
result = 31 * result + (thing2 != nuLL ? thing2.hashCode() : 0); 
return result; 
} 
} 


DemoJSON 类 初始 化 了 一 个 POJO， 导 出 它 的 JSON 形式 ， 然 后 又 解析 JSON 重新 生成 一 个 
POJO， 代 码 如 下 : 





MyPojo pojo = new MyPojo(); 
//…… 生 成 pojo 对 象 的 代码 请 参考 项 目 源码 





Gson gson = new Gson(); 
String json = gson.toJson(pojo); 


MyPojo pojo2 = gson.fromJson(json, MyPojo.class); 
DemoJackson 类 的 逻辑 类 似 ， 不 过 使 用 了 Jackson API: 


MyPojo pojo = new MyPojo(); 
ff 生成 pojo 对 象 的 代码 请 参考 项 目 源码 








ObjectMapper mapper = new ObjectMapper(); 
String json = mapper .writeValueAsString(pojo); 


MyPojo pojo2 = mapper .readValue(json, MyPojo.class); 





可 使 用 如 下 命令 运行 Java 类 : 


$ mvn exec:java -Dexec.mainClass=com.saternos.json.DemoJackson 


$ mvn exec:java -Dexec.mainClass=com.saternos.json.DemoGSON 


4.6.2 ”用 JVM 上 的 脚本 语言 处 理 JSON 


前 面 这 个 Java 的 例子 将 JSON 转换 为 Java 对 象 ， 在 其 他 语言 中 应 该 怎么 办 呢 ? JSON 基 
于 一 些 简单 的 数据 结构 (JavaScript 的 数组 和 对 象 ) 。 在 其 他 语言 中 这 对 应 数组 (或 列表 )、 
散 列 (或 字典 、 表 、 散 列表 )。 很 多 类 库 提供 了 在 JSON 对 象 和 相应 的 原生 数据 结构 之 间 互 
相 翻 译 的 功能 。 















































jvm _json (https://github.com/java-javascript/client-server-web-apps/tree/master/Chapter-4-Java- 
and-Tools/jvm_json) 项 目 展示 了 如 何 使 用 Clojure、JavaScript、Jython 和 Groovy 读 取 一 个 
JSON 文件 ， 并 且 获 取 和 输出 一 个 成 员 的 值 。 图 4-3 展示 了 如 何 使 用 scriptEngineManager 
类 ， 根 据 文件 后 级 调用 正确 的 引擎 。 











Java 工 具 | 59 








Groovy 脚 本 
(.groovy) 


Jvms.class 使 用 javax. 
script. ScriptEngineMamage: 


JavaScript 
(js) 















JavaScript 
(Rhino) 





4-3: 管理 脚本 引擎 


该 项 目的 pom.xml 包括 了 对 使 用 编程 语言 的 相关 依赖 ， 而 且 还 配置 了 如 下 两 个 插件 。 


(1) Exec Maven 插件 (http://mojo.codehaus.org/exec-maven-plugin/) 让 Java 类 和 其 他 可 执行 


基于 JVM 的 JavaScript 引擎 





本 书 的 示例 使 用 Mozilla 开发 的 Rhino JavaScript 引擎 。JavaScript 引擎 的 名 字 
O?Reilly 出 版 的 一 本 书 (http://shop.oreilly.com/product/9780596101992.do) 
而 得 名 。Oracle 公司 正在 开发 一 个 新 的 、 叫 作 Nashorn (http://openjdk.java. 
net/projects/nashorn/) 的 JavaScript 引擎 ， 将 会 随 Java 8 一 起 发 布 。 








程序 能 在 命令 行 里 执行 。 


(2) Maven S 





hade 插件 (https://maven.apache.org/plugins/maven-shade-plugin/) 是 众多 能 打包 





JAR 文 伯 





该 项 目 对 象 


Java 主 类 ( 
文件 的 后 级 





Jvms.java 有 一 个 简单 的 main 方法， 用 和 迭代 处 理 通过 命令 行 传人 参数 。 对 于 每 一 个 参 
数 ， 程 序 先 尝试 验证 是 否 存在 这 样 一 个 文件 ， 如 果 没 有 找到 ， 在 文件 名 前 加 上 src/main/ 
resources/scripts 作为 文件 的 路 径 。 这 个 目录 就 是 存放 脚本 文件 的 地 方 。 为 了 和 当前 讨论 的 
已 省 去 异常 处 理 和 其 他 无 关 细节 。 如 果 文 件 没 有 找到 ， 则 直接 从 main 方法 中 抛 


内 容 相关 ， 


的 插件 中 的 一 种 。 它 与 众 不 同 的 一 点 是 能 将 那些 命名 冲突 的 项 目 打包 成 JAR。 
当 要 实现 前 面 提 到 的 脚本 接口 时 ， 这 种 情况 司空 见 惯 。 


模型 还 包含 了 对 含有 引用 模块 的 仓库 的 引用 。 


Jvms.java) 通过 参数 读 入 一 个 脚本 文件 ， 然 后 使 用 对 应 的 脚本 引擎 执行 (基于 


名 )。 





出 异常 ( 它 
是 后 级 名 。 
件 系 统 里 读 


的 定义 里 就 有 throw Exception)。 文 件 名 里 第 一 次 发 现 点 的 位 置 以 后 的 文字 就 
最 后 初始 化 ScriptEngineManager ， 根 据 后 缀 名 得 到 一 个 相应 的 脚本 引 警 。 从 文 


取 文 件 ， 根 据 后 缀 名 交 给 对 应 的 引擎 求 值 : 
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public static void main(String[] args) throws Exception 


{ 
for (String fileName : args) { 


if (!fileName.trim().equals("")) 
File file = new java.io.File(fileName); 


if (!file.exists()) 
fileName = "src/main/resources/scripts/"+fileName; 


String ext = fileName.substring( 
fileName.indexOf(".") + 1， 
fileName. length() 

); 


new ScriptEngineManager().getEngineByExtension(ext).eval( 
new java.io.FileReader(fileName) 
); 
} 
} 
} 


可 通过 Maven 执行 该 程序 ， 一 次 可 传 入 一 个 或 多 个 脚本 作为 参数 : 


mvn -q \ 
exec:java -Dexec.args="testJson.clj testJson.js testJson.groovy testjJson.py" 


如 果 你 喜欢 ， 也 可 以 不 使 用 Maven， 而 是 用 附带 的 脚本 直接 执行 JAR 文件 : 


jvms.sh testJson.cLj testjJson.js testJson.py testJson.groovy 


Python (Jython， 参 见 http://www.jython.org/) 的 例子 简单 易 懂 。 块 内 使 用 对 齐 ， 同 时 使 用 
begin 和 end 标致 代码 的 开始 和 结束 ， 没 有 多 余 的 让 人 分 心 的 东西 ， 以 一 种 近乎 伪 代 码 的 
形式 实现 程序 功能 。Python 是 一 种 非常 规整 的 语言 ， 由 于 其 设计 的 一 致 性 ， 代 码 看 起 来 不 
易 引 起 歧义 : 








import json 
print('*** JSON Jython ***') 


for item in json.loads(open("data/test.json").read()): 
print item['title'] 
首先 从 文件 系统 中 导入 处 理 JSON 的 类 库 ， 然 后 在 对 象 上 迭代 ， 打 印 出 每 一 个 标题 。 
Groovy 的 例子 遵循 近似 的 模式 。Groovy (http:/groovy.codehaus.org/) 深度 基于 Java (一 
个 合法 的 Java 文件 通常 也 是 一 个 合法 的 Groovy 文件 )， 它 引入 了 一 些 比 纯 Java 更 紧凑 简 
洁 的 用 法 。 这 让 它 成 为 一 个 受 人 欢迎 的 、 向 Java 开发 者 推荐 的 语言 ， 他 们 既 能 沿用 已 有 的 
Java 知识 ， 也 能 学 习 Groovy 的 特色 : 
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import groovy.json.JsonSLurper 
printLn "*** JSON Groovy ***" 
def json = new File("data/test.json").text 


new JsonSLurper().parseText(json).each { println it.title } 


Clojure 的 例子 也 遵循 相似 的 形式 ， 不 过 你 也 许 会 注意 到 大 量 的 括号 。Clojure (http:/ 
clojure.org/) 是 LISP 的 方言 ， 它 和 其 他 例子 中 类 C 语言 的 语法 形成 了 强烈 的 对 比 : 


(require '[clojure.data.json :as json]) 
(println "*** JSON Clojure ***") 
(def recs (json/read-str (slurp "data/test.json"))) 


(doseq [x recs] (println (x "title"))) 
JavaScript 版 本 的 例子 略 有 不 同 。 疫 必要 导入 任何 东西 (我们 使 用 eval() 方法 仅 作 展 示 之 
用 )。 如 果 你 还 记得 ，JavaScript 没有 内 置 的 文件 读 写 功能 。 因 此 这 个 例子 用 了 点 技巧 ， 调 
用 一 个 Java 静态 方法 读 取 文件 ， 然 后 将 文件 内 容 (Java 字符 串 ) 转换 成 一 个 JavaScript 字 
符 串 ; 


println('*** JSON Javascript ***') 



































// 调用 一 个 Java 静 态 方法 读 取 文件 , 并 将 文件 内 容 转 换 成 一 个 JavaScript 字 符 串 


var str = String(com.saternos.app.Jvms.readFile("data/test.json")); 
var 0 = evall(str); 
for (var i=0; i < o.Length; i++){ 


println(o[i].title); 


} 
尽管 这 种 实现 方式 并 不 纯正 ， 但 它 展示 了 在 JVM 之 上 集成 编程 语言 是 多 么 的 方便 。 





4.7 小结 


人 们 学 习 一 门 新 的 编程 语言 ， 或 像 Maven 这 样 的 辅助 工具 的 原因 很 多 。 最 常见 的 原因 之 一 
是 因为 项 目 需 要 。 很 多 人 都 是 在 开发 Rails 应 用 或 者 使 用 Chef 或 Puppet 做 系统 管理 时 才 开 
始 使 用 Ruby 语言 的 。 科 学 家 则 因为 在 工作 中 需要 相关 的 类 库 ， 而 被 设计 规范 、 性 能 优异 
的 Python 语言 所 吸引 。 


























研究 表明 自然 语言 影响 思考 方式 。 《华尔街 日 报 》 上 一 篇 文章 (http://online.wsj.com/ 
news/articles/SB10001424052748703467304575383131592767868?mod=WSJ_LifeStyle_ 
Lifestyle_S&mg=reno64-wsj&url=http%3A%2F%2Fonline.wsj.com%2Farticle%2FSB1000142 





62 | 第 4 章 


4052748703467304575383131592767868.html%3Fmod%3DWSJ_LifeStyle_Lifestyle 5) 论述 
了 该 观点 。 文 章 描述 了 语言 是 如 何 深刻 影响 人 们 看 待 和 思考 周围 世界 的 方式 


关于 














语言 影响 思考 方式 的 一 些 发 现 如 下 。 


俄语 中 有 更 多 关于 浅 蓝 和 深蓝 的 词汇 ， 因 此 说 俄语 的 人 能 更 好 地 区 分 蓝 色 系 。 
一 些 原始 部 落 的 人 不 说 左右 ， 只 说 东南 西北 ， 固 此 他 们 的 方向 感 更 强 。 

吡 拉 哈 人 的 语言 中 没有 数字 ， 而 是 喜欢 使 用 很 少 或 很 多 这 样 的 词 ， 因 此 他 们 无 
法 精确 计数 。 

一 项 研究 表明 ， 说 西班牙 语 和 日 语 的 人 无 法 记 起 偶发 事件 中 的 人 物 ， 这 点 比 不 
上 说 英语 的 人 。 为 什么 会 这 样 ?在 西班牙 语 和 日 语 中 ， 和 芗 事 者 被 省 略 了 :他们 
说 “ 花 并 碎 了 "， 而 不 说 “ 约 划 打 碎 了 花瓶"。 


在 特定 领域 表达 能 力 越 强 的 语言 越 能 让 人 在 那个 领域 里 如 鱼 得 水 ， 编 程 语 言 也 是 如 此 。 这 
样 看 来 ， 





目的 不 是 学 习 一 门 新 的 编程 语言 ， 也 不 是 只 为 了 完成 某 个 项 目 ， 它 帮助 你 用 不 同 








的 眼光 来 看 世界 ， 从 整体 上 提高 了 你 解决 问题 的 能 力 。 大 多 数学 习 Clojure (或 其 他 LISP 
方言 ) 的 人 并 不 是 出 于 项 目 需要 ， 而 是 为 了 提高 自己 思考 和 解决 问题 的 能 力 。 在 现存 语言 
(或 所 有 可 能 的 语言 中 ，LISP 方言 以 其 简单 、 表 达能 力 强 、 强 大 和 灵活 著称 。 对 于 学 习 
其 他 语言 也 是 如 此 ， 只 不 过 程度 上 可 能 不 如 学 习 LISP 方言 这 么 深 。 每 种 语言 都 有 自己 的 
特性 和 社区 ， 和 其 他 语言 相去 其 远 。 但 是 很 多 差别 并 不 是 绝对 的 ， 即 使 不 会 马上 用 到 ， 程 
序 员 也 能 通过 学 习 其 他 语言 和 工具 帮助 自己 成 长 。 


本 章 从 和 其 他 开发 者 共同 开发 的 角度 展示 了 几 种 基于 JVM 的 语言 和 Maven。 某 些 语言 可 
能 利于 开发 者 之 间 的 交流 ， 它 们 能 以 更 好 的 方式 封装 需求 ， 方 便 日 后 对 项 目 进行 支持 和 逆 
向 工程 。Maven 能 用 来 组 织 项 目 资源 和 开发 流程 ， 在 很 多 团队 和 开发 者 中 ， 都 被 证 明 能 促 
进项 目的 成 功 。 尽 管 读书 是 一 种 个 人 行为 ， 但 程序 员 的 很 大 一 部 分 工作 都 是 和 其 他 程序 员 
合作 完成 的 。 基 于 JVM 的 语言 和 Maven 为 项 目 提供 了 合适 的 功能 ， 可 以 帮助 开发 者 在 浊 
长 的 开发 周期 中 和 其 他 开发 者 交互 。 
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第 5 章 


客户 端 框架 





“如 你 所 知 ， 任 何事 情 的 开始 阶段 都 是 最 重要 的 …… 因 为 这 段 时 间 其 特征 正在 形 
成 ， 预 期 印象 也 更 容易 被 接受 。 





一 一 柏拉图 


5.1 概述 


在 Web 面世 之 初 ， 创 建 一 个 新 的 Web 页 面 需要 先 打开 文本 编辑 器 ， 然 后 从 头 开 始 创建 
HTML 文档 。 现 在 仍然 可 以 这 样 创建 用 于 教学 的 小 示例 或 者 测试 分 离 出 来 的 JavaScript 功 
能 片段 ， 然 而 大 部 分 现代 Web 应 用 并 不 是 这 样 开始 的 ， 而 是 使 用 一 个 切实 可 行 的 项 目 模 
版 ， 包 含 组 织 良 好 的 目录 结构 、 一 些 JavaScript 库 、CSS 文件 、HTML 和 其 他 资源 文件 的 
组 合 。 不 同 项 目 间 的 选择 可 能 不 同 ， 但 一 般 都 会 处 理 项 目 一 致 性 、 跨 浏览 器 兼容 性 、 设 计 
合理 性 、 软 件 开发 实践 (如 单元 测试 )， 以 及 性 能 的 优越 性 等 问题 。 



























































一 直 以 来 ， 起 始 项 目 都 是 在 IDE 中 创建 新 项 目 时 生成 (通过 像 Maven 这 样 的 工具 ， 利 用 
原型 ) 或 者 指定 的 。 这 些 项 目 往 往 与 生成 工具 绑 定 。Web 开发 没有 标准 IDE 和 构建 工具 ， 
起 始 项 目 没有 这 样 的 绑 定 (虽然 有 到 工具 和 IDE 的 集成 )。 起 始 项 目的 复杂 度 和 目标 不 同 ， 
但 是 成 功 的 起 始 项 目 都 有 共同 特点 : 理解 、 配 置 和 部 署 都 非常 简单 。 它 们 提供 了 基本 的 基 
础 结构 来 减少 和 Web 应 用 主 用 途 没 有 直接 关系 的 枯燥 的 手工 活 。 

















起 点 的 选择 包括 了 构建 客户 端 Web 页 面 的 基础 模块 : 运行 在 Web 浏览 器 中 一 个 Web 页 面 
环境 里 的 HTML、CSS 和 JavaScript。 
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HTML 


Web 页面 


Web 浏 览 器 














5-1: 客户 端 Web 页 面 


考虑 最 多 的 环境 就 是 客户 端 自身 。 浏 览 器 有 很 多 种 ， 每 种 浏览 器 都 有 多 个 版 本 。 浏 览 器 不 
再 局 限于 桌面 应 用 ， 还 能 在 移动 设备 上 运行 。 可 运行 每 种 浏览 器 实例 的 特定 硬件 其 功能 
能 有 极 大 的 差别 。 硬 件 的 处 理 能 力 、 磁 盘 空间 、 内 存 、 屏 幕 尺 寸 以 及 显示 特征 都 可 能 不 
同 。 也 许 这 很 明显 ， 但 常常 会 被 一 些 开 发 者 忽略 ， 他 们 往往 只 关注 在 开发 机 上 运行 的 几 款 
浏览 器 。 




















起 始 项 目 可 以 面向 特定 的 内 容 、 样 式 以 及 行为 。HTML 定义 了 页 面 的 基础 结构 和 内 容 ; 
CSS 定义 了 样式 和 展现 形式 ，JavaScript 提供 了 行为 能 力 。 设 计 师 可 能 会 选择 更 小 或 CSS 
样式 更 灵活 ， 但 是 支持 各 种 插件 、 不 需要 什么 编程 的 JavaScript 库 的 起 始 项 目 。 而 开发 者 
可 能 会 选择 设计 还 过 得 去 、 能 立即 使 用 ， 但 是 利用 了 最 新 浏览 器 功能 的 前 沿 JavaScript 库 
的 起 始 项 目 。 





























起 始 项 目的 选择 也 是 基于 应 用 需求 和 受众 的 。 有 的 起 始 项 目 可 能 以 最 大 范围 的 浏览 器 兼容 
性 为 目标 ， 而 有 的 起 始 项 目 则 以 特定 移动 设备 的 高 度 优化 应 用 为 目标 。 例 如 ， 像 PhoneGap 
(http://phonegap.com/) 框架 包含 了 特别 针对 移动 设备 的 起 始 项 目 。 如 果 是 一 个 游戏 或 其 他 
需要 大 量 图 形 ， 例 如 模拟 的 项 目 ， 它 的 起 始 项 目 (https://www.npmjs.org/package/generator- 
game) 则 会 包含 与 图 形 和 物理 引擎 相关 的 JavaScript 库 。 



































特定 的 需求 可 能 意味 着 它 的 起 点 不 那么 明显 或 者 不 那么 流行 。 我 们 很 容易 迷 上 某 种 框架 
或 设计 趋势 ， 但 是 ， 项 目的 特性 可 能 需要 不 同 的 方法 。 例 如 ， 如 果 要 主动 针对 某 个 浏览 
器 〈 因 为 浏览 器 的 内 部 标准 、 目 标 用 户 群 等 )， 可 能 需要 针对 浏览 器 的 怪癖 进行 开发 ， 并 
选择 一 个 覆盖 了 这 些 问题 的 起 始 项 目 。 此 外 ， 除 了 标准 的 Web 页 面 以 外 ，HIML、CSS 和 
JavaScript 还 可 以 用 于 开发 各 种 应 用 ， 例 如 浏览 器 扩展 插件 和 原生 应 用 。 针 对 各 种 浏览 器 
和 设备 的 通用 方法 通常 是 最 优 的 ， 但 一 定 不 是 唯一 有 效 的 。 

现 如 今 ， 大 部 分 正规 的 Web 项 目 通常 都 希望 开发 出 来 的 应 用 能 够 跑 在 各 种 设备 上 并 且 所 
有 功能 都 能 正常 运行 。 绝 大 多 数 项 目 创建 时 都 有 这 样 的 愿景 ， 那 就 是 项 目 能 够 发 展 得 相对 
大 而 全 。 这 意味 着 要 用 到 与 标准 软件 模式 及 代码 组 织 相关 的 客户 端 JavaScript 框架 。 显 示 、 
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浏览 器 功能 和 设备 功能 的 区 别 ， 要 求 我 们 使 用 考虑 周全 的 设计 去 适 配 各 种 设备 ， 并 在 功能 
不 可 用 时 优雅 降级 。 在 应 用 的 生命 周期 中 用 到 的 设备 特性 会 要 求 使 用 额外 的 库 和 框架 ， 而 
传统 的 、 仅 限于 桌面 的 浏览 器 应 用 则 无 需 考虑 。 














项 目 初期 决策 的 高 成 本 或 价值 ) 





看 上 去 本 节 可 能 在 重复 一 些 显而易见 的 事情 。 那 就 选择 一 个 起 始 项 目 开 始 
做 吧 ! 























需要 在 初期 做 出 深思 熟 虑 的 选择 ， 因 为 这 个 关键 问题 会 对 后 面 的 过 程 产生 巨 
大 的 影响 。 经 济 学 家 和 社会 科学 家 使 用 了 术语 路 径 依 赖 (path dependence， 
https://en.wikipedia.org/wiki/Path_dependence) 来 描述 这 种 概念 ， 其 基本 思想 
是 “初期 决策 是 后 来 情况 的 歧化 起 因 "。 项 目 初期 引入 的 问题 很 可 能 到 后 来 
无 法 修复 。 例 如 ， 选 择 一 个 不 成 熟 的 JavaScript 库 可 能 需要 大 量 的 补丁 和 技 
巧 来 处 理 浏 览 器 兼容 问题 。 虽 然 在 开发 初期 不 明显 〈 此 时 开发 者 关注 的 是 现 
代 浏 览 器 )， 但 后 期 的 支持 会 很 繁重 ， 而 且 大 量 的 补充 代码 可 能 会 让 事情 变 
得 无 法 挽回 。 相 反 ， 一 个 考虑 周全 的 起 始 项 目 则 可 以 减少 项 目 实现 中 繁重 的 
支持 任务 。 


5.2 起 点 一 : 响应 式 Web 设 计 

2010 年 5 月 25 日 ，Ethan Marcotte 题 为 “Responsive Web Design”( 即 “响应 式 Web 设 
计 ”， 英 文 简写 为 RWD， 参 见 http://alistapart.com/article/responsive-web-design) 的 文章 出 
现在 了 4 List 4part (http://alistapart.com/) 上 。 响 应 式 Web 设计 现在 已 经 成 为 概括 他 所 表 
达 的 这 种 观点 的 通用 术语 。 这 种 设计 风格 不 对 每 种 设备 显示 做 特定 设计 ， 而 是 努力 提供 一 
种 在 各 种 设备 上 都 最 佳 的 视觉 体验 。 和 软件 的 设计 模式 (http://oreil.ly/HF-Design-Patterns， 
灵感 来 自 于 Christopher Alexander 的 架构 模式 ) 一 样 ， 这 个 概念 来 自 于 建筑 架构 。 响 应 式 
建筑 会 考虑 物理 空间 在 有 人 经 过 时 会 如 何 响应 。 而 响应 式 Web 设计 则 力求 基于 设备 的 功 
能 ， 来 适应 各 种 显示 设备 上 不 同 交互 方式 的 用 户 体验 。RWD 有 三 大 组 件 ， 如 下 。 







































































。 流体 网 格 (Fluid grid，http://alistapart.com/article/fluidgrids) 
用 于 网 页 上 排版 网 格 的 适 配 。 这 种 技术 利用 了 CSS 的 相对 大 小 来 保证 网 格 及 其 内 容 在 
上 下 文 里 的 显示 保持 合适 的 比例 。 








。 弹性 图 片 (Flexible image，http://unstoppablerobotninja.com/entry/fluid-images) 
包括 使 用 CSS 的 max-width 属性 来 让 图 片 和 其 他 媒体 在 其 父 元 素 里 泻 染 ， 以 及 其 他 相关 
的 用 于 避免 定点 样式 的 技巧 ， 大 小 固定 的 样式 会 导致 无 法 适 配 所 有 显示 设备 。 





























。 CSS3 媒 体 查询 (CSS3 media query) 
根据 页 面 泻 染 环境 的 物理 特征 使 用 特定 的 显示 单位 。 
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流体 布局 、 弹 性 图 片 〈 依 赖 于 相对 大 小 ) 以 及 CSS3 媒体 查询 (针对 固定 大 小 的 响应 式 布 
局 ) 组 成 了 RWD 的 基础 。 流 体 布局 能 等 比例 缩放 ， 而 自 适应 布局 会 在 给 定点 改变 布局 。 
这 样 可 以 避免 只 用 流 式 设计 可 能 引起 的 失真 ， 以 及 只 做 适 配 设计 时 中 间 显示 状态 的 缺失 。 


使 用 RWD 的 这 三 种 方式 ， 仅 需要 一 套 构 建 恨 好 的 Web 资源 就 可 以 创建 在 各 种 设备 上 查看 
和 有 效 使 用 的 页 面 。 对 于 这 个 问题 ，Marcotte 后 来 在 他 的 一 本 书 (http://www.abookapart. 
com/products/responsive-web-design) 中 对 这 篇 文章 介绍 的 概念 做 了 扩展 。 许 多 项 目 都 是 基 
于 这 些 原则 开发 的 ，HTMEL Boilerplate 和 Twitter 的 Bootstrap 是 其 中 的 佼佼 者 。 
































5.2.1 HTMLS Boilerplate 


HTML5 Boilerplate (http:/htmlSboilerplate.com/) 提供 了 一 套 满 足 RWD 要 求 的 资源 。 它 的 
特色 是 包括 标准 的 目录 结构 、 与 网 站 和 Web 服务 器 配置 相关 的 模板 文件 。 它 还 包括 集成 了 
normalize.css (https://necolas.github.io/normalize.css/, 提供 了 一 致 的 符合 现代 标准 的 、 跨 
浏览 器 的 演 染 样式 ) 的 CSS， 额 外 的 默认 CSS 样式 、 通 用 帮助 函数 、 媒 体 查 询 占 位 符 ， 以 
及 打印 样式 。 著 名 的 jQuery 和 Modernizr JavaScript 库 也 包含 在 内 。 





























5.2.2 Bootstrap 


Twitter Bootstrap (http://getbootstrap.com/2.3.2/) ， 被 它 的 创建 者 称 为 “用 于 快速 开发 Web 
应 用 的 前 端 工具 箱 ”(https://dev.twitter.com/blog/bootstrap-twitter)。 这 是 一 个 对 CSS 样式 
和 HTML 结构 有 特别 约定 的 集合 。 它 应 用 了 一 些 最 新 的 浏览 器 技术 ， 以 超 轻 量 的 资源 体 
职 (gzip 格式 仅 6 KB) 提供 了 美观 的 排版 、 表 单 、 按 钮 、 表 格 、 网 格 、 跳 转 以 及 其 他 所 
有 功能 。 


就 此 看 来 ， 它 比 HTML5 Boilerplate 更 优越 。 它 的 功能 在 第 2 版 (https://dev.twitter.com/ 
blog/say-hello-to-bootstrap-2) 得 到 了 进一步 增强 ， 而 且 在 社区 中 得 到 的 反馈 信息 也 帮助 了 
它 不 断 地 完善 (http://blog.getbootstrap.com/)。 使 用 Bootstrap 构建 的 站 点 饱 受 批评 ， 人 们 
认为 它们 过 于 单调 、 没 有 惊喜 ， 基 本 上 都 雷同 。 使 用 标准 的 资源 和 样式 势必 会 造成 雷同 ， 
但 实际 上 通过 手动 定制 或 者 使 用 主题 还 是 有 很 大 的 灵活 性 的 。 随 着 时 间 推 移 ， 这 个 框架 也 
变 得 更 加 “组 件 化 ”， 某 些 功能 可 以 添加 或 删除 ， 同 时 还 有 一 些 生成 工具 可 以 定制 不 同 的 
初始 资源 集 。 















































网 上 还 有 许多 类 似 的 项 目 。 如 Zurb Foundation (http://foundation.zurb.com/)， 它 的 用 户 基 
数 较 小 ， 而 且 声 称 主 要 针对 移动 设备 。 如 果 你 对 更 轻 量 的 ， 集 成 了 最 小 响应 式 设计 且 带 
有 一 些 基 本 样式 的 基础 网 格 系统 感 兴趣 ， 那 么 Skeleton (http://www.getskeleton.com/) 可 
能 值得 看 看 。 如 果 你 的 项 目 仅 仅 需 要 专业 的 、 均 衡 的 响应 式 站 点 ， 目 前 的 最 佳 选 项 还 是 
Bootstrap (可 通过 使 用 主题 和 一 些 手 动 调整 来 增强 )。 





























5.3 起 点 二 : JavaScript 库 和 框架 


语言 不 断 发 展 成 熟 的 过 程 中 会 涌现 各 种 标准 库 。 在 JavaScript 中 ， 库 不 需要 任何 特殊 结构 
或 者 打包 ， 它 们 只 是 一 些 JavaScript 文件 。 目 前 已 有 各 种 创建 好 的 库 可 用 来 帮 你 完成 你 想 
做 的 几乎 任何 事情 ， 但 同时 也 有 大 量 适 用 于 客户 端 Web 应 用 的 通用 库 。 


5.3.1 浏览 器 兼容 性 

虽然 JavaScript 是 事实 标准 ， 但 某 些 浏 览 嚣 却 特 并 独行 。 浏 览 器 生产 厂商 不 太 可 能 创建 完全 
兼容 的 实现 。 浏 览 器 厂商 要 在 两 个 方面 花费 很 大 的 精力 ， 一 方面 是 让 自己 和 别 的 浏览 器 不 一 
样 ， 另 一 方面 ， 在 功能 的 实现 上 是 为 了 驱动 标准 而 不 是 遵循 已 有 的 标准 或 指南 。 和 幸运 的 是 已 
经 有 不 少 库 对 这 些 粗糙 的 边界 做 了 平 请 处 理 ， 从 而 能 够 写 出 结果 一 致 〈 以 及 更 少 错误 或 者 破 
坏 性 的 结果 ) 的 JavaScript 代码 ， 而 不 需 关心 浏览 器 的 具体 版 本 。 表 5-1 展示 了 这 些 库 。 


表 5-1: 浏览 器 兼容 性 

库 用 途 

jQuery (http://jquery.com/) DOM 遍历 和 操作 

Modernizr (http://modernizr.com/) 浏览 器 特征 检测 

Underscore (http://underscorejs.org/) ”包括 了 对 象 和 数组 操作 的 工具 函数 











































































































jQuery 和 Modernizr 是 各 自 领 域 的 事实 标准 ，Underscore 地 位 的 稳固 性 稍 差 。 另 外 还 有 一 
些 库 提供 了 类 似 的 功能 : 简洁 一 致 、 适 用 性 广泛 的 对 象 和 数组 处 理 方 式 〈 例 如 Lo-Dash， 
参见 http:Wlodash.com/， 其 愿景 就 是 成 为 优 于 underscore 的 赫 代 品 ) 。 









































5.3.2 框架 


小 到 中 型 JavaScript 项 目 直接 进行 DOM 操作 (比如 用 jQuery) 就 好 了 。 对 大 项 目 而 言 ， 
提供 可 交互 性 数据 以 及 诸如 数据 校 验 等 附加 功能 的 JavaScript 类 ， 那 么 事情 将 会 更 简单 。 
这 些 类 可 以 被 填充 并 与 页 面 上 的 图 形 化 元 素 相 连接 。 这 种 设计 的 好 处 在 于 避免 了 直接 的 
DOM 操作 。 取 而 代 之 的 是 ， 容 器 对 象 中 数据 状态 的 变化 会 反映 到 页 面 上 。 与 页 面 的 交互 
会 引起 模型 状态 的 修改 ， 模 型 状态 的 改变 会 扩散 到 所 有 受 影响 的 视图 组 件 。 许 多 年 前 第 一 
个 MVC 框架 就 是 为 这 种 用 途 创建 的 ， 现 代 JavaScript 框架 都 已 采用 了 这 种 模式 。MVC 有 
几 种 变 体 ， 其 中 包括 模型 - 视图、 表现 器 (Model-View Presenter，MVP) 和 模型 视图 、 视 
图 模型 (Model-View View Model，MVVM) ， 因 此 术语 MV* 有 时 候 被 作为 统称 ， 用 于 将 
这 些 模型 统一 标记 为 一 个 组 。 






























































在 外 部 看 来 选择 初始 框架 会 很 困难 。 如 果 没 有 特别 的 偏好 ， 可 能 需要 花 点 功夫 来 决定 到 底 
使 用 哪个 框架 。 除 了 自身 的 开发 技巧 以 外 ， 有 一 些 基本 的 选择 标准 : 框架 提供 的 功能 及 其 
流行 程度 。 
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5.3.3 功能 


MV* 框架 非常 之 多 ， 且 其 组 成 的 这 一 列表 不 断 变化 。TODO MVC (http://todomvc.com/) 
文 个 站 点 提供 了 流行 框架 之 问 直 接 而 详细 的 比较 。 TODO MVC 利用 不 同 的 MV* 框架 实现 
了 全 功能 的 TODO 列表 应 用 ， 这 个 站 点 允许 你 来 比较 这 些 不 同 的 实现 。 























5.3.4 流行 程度 

最 流行 的 未 必 就 是 最 好 的 ， 但 框架 的 流行 程度 是 选择 它 的 合理 理由 ， 流 行程 度 代 表 了 忆 
架 是 否 有 可 靠 的 学 习 、 改 进 以 及 bug 修复 的 生态 系统 。Google Trends (http://www.google. 
com/trends) 展示 了 某 些 搜索 词 的 当前 搜索 数 ，StackOverflow 标签 (https://stackoverflow. 
com/tags) 的 数量 也 可 以 让 人 了 解 开发 者 对 一 个 主题 的 讨论 热度 。 要 更 好 地 理解 实际 使 用 
了 什么 代码 ， 可 以 查看 GitHub 仓库 (https:Wgithub.comy/trending， 以 及 还 没有 登 上 列表 头 
条 的 新 项 目的 数据 统计 ) ， 或 者 使 用 像 BuiltWith (http://builtwith.com/) 这 样 的 站 点 的 数据 
来 了 解 总 的 部 署 情况 


如 果 你 决定 要 用 某 种 主流 的 JavaScript MV* 框架 ， 你 会 想 要 看 看 或 者 从 这 个 社区 已 有 并 且 
提供 了 活跃 支持 的 项 目 起 步 。 表 5-2 列 出 了 几 种 流行 柜 架 的 起 步 项 三 
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表 5-2: JavaScript MVC 框 架 的 启动 项 目 


框架 起 步 项 目 
Backbone (http://backbonejs.org/) Backbone Boilerplate (https://github.com/backbone-boilerplate/backbone- 





boilerplate ) 
Angular (http://angularjs.org/) Angular Seed (https://github.com/angular/angular-seed) 
Ember (http://emberjs.com/) Ember Starter Kit (https://github.com/emberjs/starter-kit) 





这 些 框架 内 容 十 分 宽泛 ， 不 可 能 在 这 里 做 出 全 面 的 介绍 。 要 深入 了 解 请 参见 O’Reilly 的 
Angular (http://oreil.ly/angularJS) 和 Backbone (http://oreil.ly/dev_backbone_js_apps)。 


这 些 框架 也 并 非 唯一 选择 。JavaScript 框架 有 自己 的 依赖 ， 也 影响 了 一 些 库 去 扩展 它们 的 
核心 功能 。 比 如 jQuery 就 是 许多 项 目的 先决 条 件 ， 而 underscore.js 则 是 Backbone 的 一 
个 依赖 。Backbone 开发 者 倾向 于 使 用 require.js 来 做 脚本 加 载 和 代码 组 织 ， 它 还 促 发 了 一 
个 MV* 框 架 Spine (http://spinejs.com/)。Angular-UI (https://angular-ui.github.io/) 提 供 
了 用 户 界 面 组 件 。jQuery 促成 了 一 整个 相关 库 、 插 件 和 扩展 的 生态 系统 ， 其 中 像 jQuery 
UI (http:/jqueryui.com/) 这 样 的 大 型 库 提 供 了 各 种 控件 ， 还 有 像 TouchPunch (http:// 
touchpunch.furf.com/) 这 样 特定 功能 的 小 型 库 可 用 于 触摸 屏幕 事件 处 理 。 


还 有 其 他 起 始 项 目 ， 它 们 将 JavaScript 库 和 其 他 以 浏览 器 兼容 性 和 响应 式 设计 为 目标 的 
起 始 项 目 结合 到 了 一 起 。 有 一 个 结合 了 Angular UI 和 Bootstrap (https://angular-ui.github. 
io/bootstrap/) 的 项 目 ， 可 以 拿 来 与 jQuery UI 和 了 Bootstrap (https://github.com/jquery-ui- 










































































bootstrap/jquery-ui-bootstrap) 项 目 比 较 。 


除了 MVC 框 架 ， 如 果 要 写 jQuery 插件 ， 你 还 可 以 使 用 jQuery Boilerplate (http:/ 
jqueryboilerplate.com/) 来 配置 合适 的 项 目 结构 。 如 果 你 正在 写 样板 代码 并 且 确 定 他 人 也 一 
定 会 遇 到 同样 的 问题 ， 那 就 有 必要 上 网 找 一 找 看 是 否 已 经 有 现成 的 起 始 项 目 。 


5.4 获取 起 始 项 目 


有 几 种 不 同 的 方法 获取 起 始 项 目 来 帮助 你 开局 开发 之 旅 。 


5.4.1 直接 从 仓库 下 载 


大 多 数 项 目 都 维护 在 线 上 的 公共 源码 库 ， 通 常 是 GitHub (https://github.com/)。 





























GitHub 仓库 “名 人 堂 ” 
起 始 项 目 、 推 进 响 应 式 Web 设计 的 资源 以 及 JavaScript 库 都 属于 Github 上 最 受 欢迎 的 
仓库 (https://github.com/trending)。 
。 响应 式 设计 资源 
— Modernizr (https://github.com/Modernizr/Modernizr) 
— Normalize CSS (https://github.com/necolas/normalize.css) 
。 起 始 项 目 
— Bootstrap (https://github.com/twbs/bootstrap) 
— HTMLS Boilerplate (https:Wgithub.com/h5bp/html5-boilerplate ) 
。 JavaScript 库 
— jQuery (https://github.com/jquery/jquery) 
— Backbone (https://github.com/documentcloud/backbone) 
— Foundation ( https://github.com/zurb/foundation ) 
— Angular (https://github.com/angular/angular.js) 
— Underscore (https://github.com/jashkenas/underscore) 
— Ember (https://github.com/emberjs/ember.js) 
— jQuery UI (https://github.com/jquery/jquery-ui) 
— Knockout ( https:// github.com/knockout/knockout) 











5.4.2 ”从 入 门 网 站 下 载 
类 似 Initializr (http:/www.initializr.com/) 和 HTML5 Reset (http://html5reset.org/) 的 网 站 
主要 依赖 源 代码 库 ， 但 是 也 包括 了 评论 、 对 比 、 起 始 项 目 文档 、 常 规 开 发 和 设计 话题 。 
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5.4.3 IDE 生 成 的 起 始 项 目 

类 似 WebStrom (一 个 由 JetBrains 公司 开发 的 商业 项 目 ) 的 集成 开发 环境 ， 提 供 让 用 户 
从 模板 中 创建 新 项 目的 选项 ， 如 图 5-2 所 示 。WebStrom 包括 本 章 讨 论 的 一 些 项 目 ， 以 
及 Node.js (Node.js boilerplate, https://github.com/robrighter/mode-boilerplate) 和 Node.js 
express (http://expressjs.com/) 和 Dart (https://www.dartlang.org/) 起 始 项 目 。 

















JetBrains WebStorm 
Ww Welcome to JetBrains WebStorm 


Recent Projects Quick Start 


[er Create New Project 


@ne Create New Project 














Project name: untitled 
Location: /Users/cs/Desktop/bookprojects/client-server-web-apps/Char| - | 


ee 

HTMLS Boilerplate 

(3 Twitter Bootstrap 
- Foundation 


Node.js Express App 
Node.js Boilerplate 
Dart Web Application 











JetBrains WebStorm 6.0.1 Build 127.122. Check for updates now. 








5-2: 客户 端 起 始 项 目 


5.5 ”前端 工程 师 的 崛起 


显然 ， 现 在 的 Web 开发 已 经 比 早期 复杂 得 多 了 。 不 具备 也 不 关注 关键 开发 技能 的 设计 师 
不 可 能 跟 上 最 新 的 发 展 。 同 样 的 ， 服 务 端 开发 者 也 大 多 不 具有 成 熟 的 设计 能 力 ， 对 客户 端 
的 最 新 发 展 也 不 了 解 。 这 就 促使 了 一 个 新 职业 的 崛起 : 前 端 工程 是。 如 果 讨 论 的 这 些 话题 
还 不 足以 使 你 相信 新 信息 的 大 爆炸 ， 那 么 就 请 考虑 下 与 客户 端 开发 和 流程 相关 的 一 些 细微 
差别 。 


5.5.1 客户 端 模板 


前 面 介 绍 的 一 些 JavaScript 框架 内 置 了 JavaScript 模板 方案 。 还 有 























I 





他 各 种 各 样 的 独立 模 





入 后 
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板 ， 很 多 都 可 以 和 框架 的 内 置 模板 任意 替换 。LinkedIn (http:Wlinkd.in/1ldnFOzZ) 的 工程 师 
在 决定 使 用 dustjs (http://akdubya.github.io/dustjs/) 之 前 调研 了 多 达 26 种 客户 端 模板 技术 。 
这 个 领域 还 有 一 些 吸 引 人 的 发 展 ， 例 如 能 够 在 需要 时 将 失效 备 援 的 任务 交 给 服务 端的 客户 
端 JavaScript 模板 。 











5.5.2 ”资源 管道 
老式 的 Web 开发 只 是 简单 地 编辑 并 引用 自己 Web 服务 器 上 的 相关 资源 。 而 现在 资源 可 以 
由 外 部 的 内 容 分 发 网 络 (CDN) 提供 。 另 外 ， 资 源 不 再 是 简单 地 编辑 和 引用 ， 而 是 通常 在 
做 了 各 种 预 处 理 之 后 才 放 到 Web 服务 器 上 提供 服务 。 资 源 管道 可 用 于 预 编译 、 合 并 ， 以 及 
压缩 可 用 的 Web 资源 ， 并 实现 这 些 资 源 的 缓存 管理 。 









































在 过 去 的 几 年 ，Ruby 社区 出 现 了 资源 编译 器 。 早 期 的 例子 是 Jammit (http://documentcloud. 
github.io/jammit/) 和 Sprockets (https://github.com/sstephenson/sprockets)。 后 来 ， 管 道 资源 被 
纳入 到 Rails 并 且 被 其 他 语言 的 Web 框架 采用 ， 例 如 Java’s Play2 (https://www.playframework. 
com/documentation/2.0/Assets ) 。 








资源 管道 可 用 于 多 项 任务 。 有 的 可 以 用 在 提供 较 大 文件 时 减少 网 络 延 时 。JavaScript 和 
CSS 文件 可 以 被 精简 (去除 空格 和 多 余 字 符 )、 合 并 (减少 网 络 总 请 求 次 数 ) 和 压缩 (使 
用 gzip 或 其 他 压缩 算法 )。 还 有 些 资源 管道 会 用 于 与 缓存 相关 的 任务 。 例 如 ，Play 框架 使 
用 ETag HTTP Headers (http://en.wikipedia.org/wiki/JHTTP_ETag) 追加 一 个 由 资源 名 称 和 文 
档 最 后 改变 日 期 生成 的 值 ， 并 提供 了 设置 Cache-Control 头 信息 的 选项 。 





























另外 ， 预 处 理 步骤 可 以 把 其 他 语言 编译 成 JavaScript (例如 CoffeeScript 和 Dart， 分 别 参见 
http://coffeescript.org/ 和 https://www.dartlang.org/)。 这 也 给 了 那些 不 太 喜 欢 JavaScript 这 门 
语言 本 身 的 人 一 些 选 择 。 


对 CSS 也 可 以 进行 预 处 理 ， 这 样 做 可 以 减少 重复 代码 。 重 复 的 代码 越 少 应 用 越 容易 维护 ， 
当然 这 需要 增加 额外 的 编译 步骤 。 预 编译 器 需要 在 被 HTML 页 面 引用 之 前 处 理 原始 文件 ， 
并 解析 代码 中 的 引用 以 生成 标准 的 样式 表 。 以 下 是 CSS 编译 器 的 几 种 预 处 理 类 型 : 
。 在 整个 样式 表 中 定义 可 以 替换 的 变量 值 〈 例 如 ， 在 许多 CSS 类 中 定义 的 颜色 值 ) ; 
。 创建 接受 不 同 参数 的 方法 为 类 赋值 ; 
。 实现 CSS 类 的 继承 。 

































































sr 


























ds 











CSS 处 理 器 起 源 于 Ruby 开发 者 ， 但 是 已 经 在 Java 社区 获得 认可 。LESS CSS Maven 插件 
(http://mojo.codehaus.org/lesscss-maven-plugin/) 就 是 一 个 例子 。 

在 资源 管道 中 实施 预 编译 步骤 多 少 有 些 和 争议 。 对 那些 从 来 不 是 只 处 理 硬 编 码 CSS 的 设计 师 
来 说 ， 预 处 理 器 可 能 带 来 的 编程 工作 会 令 他 们 感到 不 安 。 尽 管 开 发 者 可 能 更 接受 预 处 理 器 
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的 概念 (基于 它们 在 其 他 编程 环境 中 的 使 用 ),， 但 是 改变 任何 人 的 工作 流程 都 是 令 人 不 安 
的 。 这 就 需要 前 端 开发 工程 师 这 样 一 个 新 角色 来 填补 开发 者 和 设计 师 之 间 的 空白 ， 他 们 需 
要 独特 的 工作 流 以 及 合适 的 工具 集 来 展开 他 们 的 职责 工作 。 








5.5.3 ”开发 流程 

Yeoman (http://yeoman.io/) 是 一 个 基于 node 的 包 ， 它 利用 三 个 工具 提供 了 一 套 开 发 流 
程 。 这 三 个 工具 是 : yo (https:Wgithub.com/yeoman/yo， 用 于 脚手架 )、grunt (http://gruntjs. 
com/， 用 于 编译 ) 和 bower (http://bower.io/， 用 于 包 管 理 )。 其 他 基于 node 的 包 例 如 
karma (用 于 测试 ) 和 Docco (用 于 生成 文档 ) 也 可 用 于 开发 和 构建 流程 。 


5.6 项 目 


有 兴趣 了 解 最 简单 框架 示例 的 价值 ， 以 及 框架 与 功能 完备 的 起 始 项 目 之 间 的 关系 ， 可 以 孝 
虑 下 面 使 用 Angular 的 示例 : 


























<!doctype html> 
<html ng-app> 
<head> 
<script src="http://code.angularjs.org/1.0.6/angular.min.js"></script> 
</head> 
<body> 
Angular Expression 1 + 2 evaluates to: {{ 1+2 }} 
</body> 
</htmL> 








Angular 框架 的 作用 是 显而易见 的 ， 因 为 在 文档 中 有 很 多 XML 属性 〈 称 为 指令 )， 它 们 并 
不 是 文档 中 标准 HTML 的 内 容 。 在 这 个 例子 中 ，ng-app (https://docs.angularjs.org/api/ng/ 
directive/ngApp， 在 HTML 标签 中 ) 用 于 自动 引导 应 用 。 这 类 属性 在 一 个 HTML 页 面 中 只 
能 出 现 一 次 。 它 指定 了 应 用 的 根 ， 并 可 以 选择 性 地 指定 一 个 模块 名 (尽管 在 这 个 例子 中 它 
是 空 的 )。script 标签 说 明 使 用 了 Angular; 还 可 以 包括 提供 了 其 他 辅助 功能 的 Angular 脚 
本 。 最 终 ，Angular 中 可 见 的 功能 会 通过 表达 式 (http://docs-angularjs-org-dev.appspot.com/ 
guide/expression) 展现 。Angular 表达 式 是 类 似 于 JavaScript 的 代码 片段 ， 它 被 放置 于 两 对 
花 括 号 之 间 解 析 成 输出 。 

































































这 是 一 个 很 简单 的 只 对 表达 式 求 值 的 示例 。 它 甚至 都 没有 演示 出 Angular 的 MV* 框架 特 
性 ， 因 为 例子 中 没有 包括 控制 器 和 数据 绑 定 。 它 仅仅 说 明了 创建 一 个 Angular 应 用 所 必 
的 最 小 特征 。 下 面 这 个 例子 包括 了 模型 和 控制 如 




















<!doctype html> 
<htmL ng-app> 
<head> 
<script src="http://ajax.googLeapis.com/ajax/Libs/anguLarjs/1.0.6/angutLar.min.js"> 
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</script> 


<script> 
function HelloCntl($scope) { 
$scope.name = 'World'; 
} 
</script> 
</head> 
<body> 





<div ng- 控制 器 ="HeLLoCntL"> 
Your name: <input type="text” ng- 模 型 ="name" /> 
<hr/> 
Hello {{name}}! 
</div> 
</body> 
</htmL> 


在 Angular 中 一 个 控制 器 (https://docs.angularjs.org/guide/dev_guide.mvc.understanding_ 
controller) 其 实 就 是 一 个 函数 ， 用 于 在 指定 的 作用 域内 实现 行为 。 在 这 个 例子 中 ， 控 制 器 
用 于 把 模型 (https://docs.angularjs.org/guide/dev_guide.mvc.understanding_model，name 变 


量 ) 绑 定 到 输入 框 。 输 入 框 中 值 的 变化 会 立即 反映 到 表达 式 中 。 作 为 一 个 框架 ， 提 供 远程 
Ajax 服务 调用 是 非常 重要 的 。 最 终 示 例如 下 : 


























<!doctype html> 
<htmL ng-app="GoogleFinance"> 


<head> 
<script src="http://ajax.googleapis.com/ajax/libs/angularjs/1.0.6/angular.min.js"> 
</script> 
<script src="http://code.angularjs.org/1.0.6/angular-resource.js"></script> 
<script> 


anguLar .module('GoogleFinance', ['ngResource']); 


function AppCtrl($scope, S$resource) { 
$scope.googleFinance = S$resource('https://finance.google.com/finance/info', 
{client:'ig',q: 'AAPL',callback:'JSON_ CALLBACK'}, 
{get: {method:'JSONP',isArray: true}}); 


$scope.indexResult = $scope.googleFinance.get(); 


$scope.doSearch = function () { 
$scope.indexResult = $scope.googleFinance.get({q: $scope.searchTerm}); 
}; 
} 
</script> 
</head> 
<body> 
<div ng- 控制 器 ="AppCtrL"> 
<form class="form-horizontal"> 
<input type="text”ng- 模 型 ="searchTerm"> 
<button class="btn" ng-click="doSearch()"> 
Search 
</button> 
</form> 
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Current Price: {f{tindexResuLt[0].L_cur}j<br/> 
Change: {{indexResult[0].c}}<br/> 
</div> 
</body> 
</htmL> 





Angular resource (https://docs.angularjs.org/api/ngResource/service/$resource) 用 于 进行 后 端 
的 调用 。 需 要 引入 其 定义 脚本 ， 而 且 需 要 在 控制 器 中 作为 参数 传递 。 因 为 这 是 一 个 跨 域 调 
用 ， 所 以 用 到 了 JSONP。searchTern 模型 通过 谷歌 财经 API 来 搜索 股票 代码 ， 返 回 结果 是 
一 个 JSON 数组 ， 并 且 当 前 价格 和 变更 的 字段 会 显示 在 检索 结果 中 。 


这 三 个 例子 有 助 于 教学 和 示范 。 它 们 做 了 简化 以 强调 哪些 功能 是 必需 的 ， 以 及 它们 之 间 的 
关系 。 





























添加 Bootstrap 的 样式 表 和 一 些 基 本 风格 样式 也 并 不 费事 。 本 章 的 代码 与 之 前 的 例子 相 比 增 
加 了 一 些 额外 的 变化 ， 这 是 通过 引入 bootstrap.css、 创 建 容器 类 和 一 些 视图 行 并 增加 搜 
索 图 标 和 调整 设计 来 实现 的 。 这 些 东 西 全 都 在 同一 个 文件 里 面 ， 一 个 标准 的 起 始 项 目 会 将 
这 些 资源 打 散 并 用 标准 的 目录 结构 组 织 它们 。 














通过 将 上 述 代码 的 相关 部 分 与 索引 页 (或 相关 视图 ) 相关 联 ， 可 以 将 这 些 例子 添加 进 类 似 
AngularJS 或 Bootstrap 的 起 始 项 目 中 。 理 想 情 况 下 ， 应 该 将 这 些 例子 中 的 内 置 JavaScript 
代码 提取 出 来 写 入 独立 的 文件 (将 模块 写 入 app.js， 将 控制 器 写 入 controllers.js)。 























5.7 ”小结 


在 任 一 成 功 的 开发 团队 中 ， 每 个 成 员 都 利用 其 独特 的 优势 共同 为 项 目的 效益 做 贡献 。 一 个 
成 员 对 自己 领域 的 专注 使 其 他 成 员 能 够 密切 关注 其 他 领域 ,这 就 有 效 地 将 问题 控制 在 他 们 
的 关注 范围 内 。 起 始 项 目 和 JavaScript 框架 使 得 开发 者 不 用 关心 BOM 和 DOM 的 实现 细 
节 、 浏 览 器 兼容 性 、 初 始 代码 组 织 等 问题 和 其 他 挑战 。 


硬件 的 提升 和 JavaScript 性 能 的 优化 使 我 们 能 够 创建 大 型 JavaScript 应 用 。 当 使 用 标准 的 设 
计 ， 并 通过 减少 Web 开发 项 目 中 的 重复 任务 来 专注 于 项 目 重点 时 ， 大 型 应 用 的 管理 就 会 变 
得 更 加 轻松 。 本 章 所 介绍 的 这 些 框架 可 以 帮助 你 快速 地 创建 并 启动 你 的 项 目 ， 并 使 你 的 项 
目 成 员 可 以 立即 专注 于 功能 的 实现 。 
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“一 个 只 关心 自己 的 人 不 足以 成 大 器 。” 
一 一 本 杰 明 。 富 兰 克 林 





将 可 重用 的 组 件 打包 这 一 点 让 扩展 编程 语言 的 能 力 成 为 可 能 。 对 于 一 门 特定 的 语言 ， 打 包 
会 影响 到 部 署 方式 。 打 包 需 要 考虑 标准 命名 规范 、 元 数据 文件 、 数 字 签 名 、 代 码 混淆 、 代 
码 管 理 、 包 含 相关 的 文件 /资源 ， 以 及 压缩 机 制 。 





打包 会 影响 部 署 。 事 实 上 ,一 门 语言 提供 的 部 署 选项 能 左右 一 个 项 目的 结构 和 开发 流程 ， 
在 Java 中 尤其 如 此 。Java 源 文件 的 名 字 反 映 了 其 包含 的 公有 类 的 名 字 ，Java 的 包 结 构 遵循 
文件 系统 中 的 目录 结构 。Java 使 用 了 多 个 不 同类 型 的 包 格 式 。 一 般 的 代码 被 打包 到 Java 归 
档 文 件 (JAR)，Web 应 用 被 打包 到 Web 应 用 归档 文件 (WAR), 一 组 相关 的 Web 应 用 被 
打包 到 企业 级 应 用 归档 文件 (EAR)。WAR 可 以 被 部 署 到 servlet 容器 中 ， 而 EAR 需要 完 
整 企 业 级 Java 的 支持 ， 必 须要 有 类 似 JBoss 这 样 的 应 用 服务 器 。 











Java 的 打包 模型 有 很 多 优点 ， 但 却 限制 了 部 署 的 可 能 性 。 从 Java 发 展 的 初期 ， 标 准 Web 
应 用 的 开发 实践 就 要 求 独立 安装 和 配置 应 用 服务 器 。 然 而 实际 上 这 些 并 不 是 部 署 Java Web 
应 用 所 必需 的 。 即 使 使 用 了 一 个 Web 容器 ， 也 有 可 能 在 开始 开发 前 避免 安装 和 配置 它 所 带 
来 的 开销 。 


6.1 更 简单 的 服务 器 端 解决 方案 


客户 端 技术 的 爆发 势不可挡 ， 这 源 于 将 浏览 器 作为 平台 所 带 来 的 挑战 、JavaScript 语言 和 
为 了 管理 复杂 性 而 开发 出 来 的 JavaScript 类 库 。 男 一 复杂 性 来 自 和 设备 相关 的 开发 ， 它 可 
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以 是 移动 设备 上 的 Web 应 用 ， 也 可 以 是 通过 HTTP 调用 Web 服务 的 原生 应 用 。 然 而 ， 可 
喜 的 是 在 这 种 新 的 客户 端 - 服务 器 端的 Web 应 用 模型 里 ， 服 务 器 端的 代码 被 简化 了 。 


传统 上 ，Web 应 用 是 一 个 相当 大 的 结构 ， 它 可 以 跑 在 应 用 服务 器 上 、Web 容器 里 或 者 
Web 服务 器 上 。 写 作 此 书 时 ， 值 得 尊敬 的 Apache Web 服务 器 (https://www.openhub.net/p/ 
apache) 拥有 超过 200 万 行 代 码 ， 需 要 成 百 上 千 的 人 年 ' 才 能 完成 。J2EE 开发 的 复杂 性 声 
名 狼藉 (以致 在 最 近 版 本 的 JEE 中 对 其 进行 了 大 幅 地 简化 )。 服 务 器 端的 模型 - 视图 - 控 
制 项 目 (Struts) 和 依赖 注入 框架 (Spring) 提供 了 组 织 功 能 ,减轻 了 配置 的 负担 ， 同 时 突 
出 了 开发 Java Web 应 用 时 对 服务 器 端 所 要 求 的 规模 和 可 伸缩 性 。 


客户 端 一 服务 器 端 架构 的 Web 应 用 使 用 的 服务 器 不 维持 会 话 状态 ， 大 多 由 简单 的 API 组 
成 。 尽管 它们 可 以 利用 中 间 件 支持 Web 服务 ,但 它们 常常 不 这 样 做 。 直 接 或 间接 受到 来 自 
脚本 语言 世界 的 影响 ， 现 在 建立 一 个 最 小 化 的 服务 器 非常 简单 ， 它 可 以 为 前 端 开发 者 提供 
必需 的 功能 ， 让 他 们 在 没有 一 个 完整 的 服务 器 端 实现 的 条 件 下 也 能 工作 。Java 和 其 他 基于 
JVM 的 语言 为 开发 者 提供 了 很 多 可 能 性 ， 开 发 者 可 以 在 一 个 项 目 里 包括 所 有 服务 器 端的 功 
能 ， 而 不 需要 安装 、 配 置 和 维护 一 个 完整 的 服务 器 实现 。 和 以 前 相 比 ， 这 为 开发 流程 提供 
了 截然 不 同 的 可 能 性 。 除 了 开发 时 会 受益 ， 这 种 轻 量 级 的 服务 器 解决 方案 也 让 将 应 用 部 署 
到 云 环境 下 时 的 水 平 扩展 变 得 简单 了 。 


使 用 Java 或 利用 一 些 类 库 就 可 以 创建 “无 容器 ”的 Web 应 用 服务 器 。 图 6-1 展示 了 本 章 
用 到 的 服务 器 和 它们 之 间 的 关系 。 图 上 方 的 类 库 基础 设施 更 稳固 ， 理 论 上 对 适合 某 领域 的 
框架 来 说 ， 它 们 是 个 更 高 效 的 起 点 。 这 里 并 没有 列 出 所 有 的 服务 器 ， 但 可 以 从 多 维度 对 其 
扩展 。 比 如 各 种 基于 JVM 的 语言 都 有 对 应 的 Web 框架 (JRuby 有 Sinatra、Rails ，Jython 
有 Django) 。Typeset (http://typesafe.com/) 是 一 个 基于 Play 的 Scala 框架 。vertx (http:/ 
vertx.io/) 尤为 特别 ， 它 支持 多 种 JVM 语言 。 





















































Play Web 开 发 者 
Restlet Roo (Saala/Java) ” 框架 
Jetty Netty 底层 类 库 
Java 虚 拟 机 











6-1: 服务 器 类 库 


本 章 的 例子 限于 以 Java 为 中 心 的 工作 流 和 构建 流程 。 林 于 JVM 的 语言 根据 其 起 源 不 同 ， 
有 不 同 的 工作 流 实践 。Groovy 和 Scala 的 初始 目标 平台 就 是 JVM， 而 Ruby 和 Python 是 后 








注 1: 表示 人 口 生存 时 间 长 度 的 复合 单位 ， 是 人 数 同 生存 年 数 乘积 的 总 和 。 例 如 一 个 人 生存 一 年 是 1 人 年 ， 
两 个 人 各 生存 半年 也 等 于 1 人 年 ， 这 三 个 人 共生 存 2 人 年 。 
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来 移植 到 JVM 的 语言 。Groovy (和 Scala 中 的 少数 ) 使 用 的 技术 和 实践 有 迹 可 寻 ，Java 开 
发 者 很 熟悉 其 中 的 模式 。JRuby 和 Jython 起 源 不 同 ， 它 们 的 方式 对 Java 开发 者 来 说 就 不 那 
么 熟悉 了 (但 是 那些 从 其 他 实现 迁移 到 JVM 的 开发 者 却 认 可 这 种 方式 )。 这 就 要 求 读者 使 
用 各 自 社 区 特有 的 开发 安装 流程 、 工 具 链 和 命令 。 


6.2 ”基于 Java 的 服务 器 


可 以 单独 使 用 Java， 或 者 使 用 一 些 高 级 的 类 库 编 写 服务 器 端 。 很 多 时 候 使 用 的 是 一 种 基 
本 的 模式 : 服务 器 类 将 请 求 委托 给 一 个 处 理 器 ， 处 理 器 继承 了 一 个 抽象 类 或 实现 了 一 个 接 
口 ， 该 类 或 接口 定义 了 一 个 handle 方 法。 图 6-2 展示 了 服务 器 类 和 处 理 器 类 之 间 的 基本 关 






























































系 。 具 体 的 处 理 器 实现 了 handle 方法， 在 下 面 的 例子 中 ， 处 理 器 返回 一 个 JSON 对 象 。 





























+main():void +handle():void 














图 6-2: 服务 器 -处 理 器 类 图 


关于 例子 





和 本 书 其 他 一 些 例子 类 似 ， 我 们 对 本 章 的 例子 有 意 做 了 简化 ， 让 其 和 当下 讨 
论 的 主题 相关 。 比 如 ， 很 多 JSON 响应 都 是 简单 的 字符 串 。 在 现实 中 ， 更 常见 
的 情况 是 使 用 Jackson 或 其 他 类 库 来 构建 响应 。 大 多 数 开 发 者 都 会 工作 在 高 级 
的 、 功 能 完整 的 框架 之 上 ， 但 使 用 字符 串 能 将 书 中 出 现代 码 的 含义 表达 得 更 清 
楚 。 在 实际 项 目 中 使 用 类 库 和 注释 看 起 来 整齐 、 高 效 、 意 义 明确 ， 但 在 示例 代 
码 中 会 隐藏 过 多 的 功能 ， 代 码 即 使 在 最 好 的 情况 下 看 起 来 也 不 会 很 清楚 。 
































这 些 例 子 的 意义 在 于 展示 不 总 是 需要 应 用 服务 器 ， 编 写 可 以 工作 的 、 有 特殊 
用 途 的 服务 器 是 一 件 非 常 简单 的 任务 。 很 多 开发 选择 使 用 高 级 的 框架 ， 但 是 
知道 底层 的 类 库 是 怎样 工作 的 以 后 ， 能 帮助 调试 和 分 析 堆 栈 错误 跟踪 信息 和 


日 志 。 


























6.2.1 _ Java HTTP 服务器 

Java 标准 版 附带 了 一 个 HTTP 服务 器 API， 可 以 用 它 来 创建 一 个 简单 、 能 工作 的 嵌入 式 
HTTP 服务 器 。 下 面 的 程序 不 需要 任何 外 部 依赖 。 它 监听 8000 端口 ， 对 进来 的 请 求 返回 一 
个 成 功 的 HTTP 响应 (200)， 响 应 内 容 为 如 下 的 JSON 对 象 : 


{"testResponse":"Hello World"} 
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这 里 需要 一 个 Java 源 文件 ， 包 含 一 个 定义 了 main 方法 的 类 。 在 main 方法 中 ， 创 建 了 一 个 
服务 器 实例 ， 该 服务 器 实例 根据 URL 将 请 求 委托 给 一 个 静态 处 理 器 (这 里 被 定义 为 一 个 
静态 内 部 类 ) : 





import java.io.*; 
import com.sun.net.httpserver.*; 
import java.net.InetSocketAddress; 


public class HttpJsonServer { 
public static void main(String[] args) throws Exception { 


HttpServer server = HttpServer .create( 
new InetSocketAddress(8000), 0 
); 
server.createContext("/", new MyHandler()); 
server .setExecutor (null); 
System.out.println("Starting server on port: 8000"); 
server.start(); 


J} 
static class MyHandler implements HttpHandler { 


public void handle(HttpExchange t) throws IOException { 
String response = "{\"testResponse\":\"Hello World\"}"; 
t.getResponseHeaders().set( 

"Content-Type", 

"application/json" 
); 
t.sendResponseHeaders(200, response.length()); 
OutputStream os = t.getResponseBody(); 
os.write(response.getBytes()); 
os.close(); 


} 
这 个 例子 非常 简单 ， 没 有 外 部 依赖 ， 也 不 需要 构建 脚本 ， 只 需要 编译 运行 即 可 : 





$ javac HttpJsonServer .java 
$ java HttpjsonServer 
Starting server on port: 8000 





可 以 在 另外 一 个 命令 行 会 话 里 使 用 Curl 访问 服务 器 : 





$ curl -i http://Llocalhost:8000 
HTTP/1.1 200 OK 

Content-type: application/json 
Content-Length: 30 

Date: Sun, 09 Jun 2013 01:15:15 GMT 


{"testResponse":"Hello World"} 





显然 这 不 是 一 个 功能 完备 的 例子 ， 但 是 它 表明 使 用 Java 开发 一 个 能 工作 的 HTTP 服务 器 是 


一 个 相对 简单 可 实现 的 目标 。 


6.2.2 ”Jetty 骨 入 式 服务 器 


Jetty (http://www.eclipse.org/jetty/) 是 一 个 基于 Java 的 HTTP 服务 器 和 Java Servlet 容器 ， 
它 由 Eclipse 基金 会 维护 。 除 了 自身 是 Eclipse IDE 的 一 部 分 ， 它 还 被 用 在 很 多 产品 中 ， 比 
如 ActiveMQ、Maven、Google App Engine 和 Hadoop。 它 不 仅仅 是 一 个 Web 服务 器 ， 它 还 


支持 Java Servlet API、SPDY 和 WebSocket 协议 。 


发 者 至 少 知 道 它 的 存在 和 功能 。 但 是 ， 很 少 人 知道 


制 的 Java 服务 器 。 








因为 这 么 多 项 目 中 都 用 到 了 它 ， 很 多 开 
它 可 以 容易 地 作为 一 个 组 件 衣 入 一 个 定 





基于 Jetty 的 服务 器 需要 包含 外 部 模块 ， 因 此 需要 一 个 构建 脚本 。 在 一 本 书 中 描述 Maven 


配置 的 挑战 之 一 是 pom.xml 太 过 庞大 宛 长 。Gradle 配置 相对 更 简短 扼要 。 





下 面 的 Gradle 配置 包括 了 Jetty， 而 且 增 加 了 一 个 启动 服务 器 的 任务 : 











appLy plugin:'java' 


repositories{mavenCentral()} 
dependencies{compile 'org.eclipse.jetty:jetty-server:8.1.0.RC5'} 


task(startServer, dependsOn: 'classes', type: JavaExec) { 


main = 'com.saternos.embedded.TestJettyHttpServer' 
classpath = sourceSets.main.runtimeClasspath 
args 8000 


} 

















其 遵循 的 模式 和 单纯 基于 Java 的 例子 类 似 ， 定 义 了 一 个 处 理 器 类 返回 一 个 JSON 响应 : 








package com.saternos.embedded; 


import java.io.IOException; 

import javax.servlet.ServletException; 

import javax.servlet.http.HttpServletRequest; 

import javax.servlet.http.HttpServletResponse; 

import org.eclipse.jetty.server.Request; 

import org.eclipse.jetty.server.handler.AbstractHandler; 


public class JsonHandler extends AbstractHandler 
t 
public void handle( 
String target, 
Request baseRequest, 
HttpServletRequest request, 
HttpServletResponse response 


throws IOException, ServletException 
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response.setContentType("application/json;charset=utf-8"); 
response.setStatus(HttpServletResponse.SC_OK); 
baseRequest .setHandled(true); 
response.getWriter().println( 

"{\"testResponse\":\"Hello World\"}" 
); 


} 
main 方法 创建 了 一 个 服务 器 实例 ， 服 务 器 对 象 将 接收 到 的 请 求 委 托 给 处 理 器 : 





I 

















package com.saternos.embedded; 
import org.eclipse.jetty.server.Server; 


public class TestJettyHttpServer 


{ 
public static void main(String[] args) throws Exception 
{ 
Server server = new Server(Integer.parseInt(args[0])); 
server .setHandler (new JsonHandler()); 
System.out.println("Starting server on port: " + args[0]); 
server.start(); 
server .join(); 
} 
} 


使 用 Gradle 构建 和 运行 服务 器 : 


$ gradle build startServer 


通过 Curl 得 到 的 响应 正如 你 所 期 待 的 那样 ， 同 时 返回 一 个 引用 ， 指 明 服 务 器 是 Jetty: 





$ curl -i http://Llocalhost:8000 

HTTP/1.1 200 OK 

Content-Type: application/json;charset=utf-8 
Content-Length: 31 

Server: Jetty(8.1.0.RC5) 


{"testResponse":"Hello World"} 
0 果 你 倾向 于 从 头 开始 编写 一 个 定制 API 的 服务 器 ，Java 自 带 的 基本 模块 或 者 像 Jetty 这 
样 的 扩展 类 库 就 足够 了 。 很 多 和 编写 Web API 相关 的 项 目 都 在 内 部 使 用 了 Jetty， 比 如 


Restlet 。 


3 

















6.2.3 Restlet 

Restlet API (http://restlet.com/) 是 直接 按照 REST 的 概念 设计 的 ， 资 源 、 表 示 、 连 接 器 、 
组 件 和 媒体 类 型 。 使 用 该 框架 可 自然 地 实现 REST API。 尽 管 下 面 的 例子 不 是 纯 RESTful 
的 ， 但 依然 展示 了 只 需要 很 少 的 一 点 代码 就 能 创建 一 个 返回 JSON 的 服务 器 : 
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package com.saternos.embedded; 


import org.restlet.*; 

import org.restlet.data.*; 

import org.restlet.resource.*; 

import org.restlet.ext.json.JsonConverter; 


public class TestRestletHttpServer extends ServerResource { 


public static void main(String[] args) throws Exception { 
Component component = new Component(); 
component .getServers().add(ProtocoL.HTTP，Integer .parseInt(args[0])); 
Component .getDefauLtHost() .attach("/"，TestRestLetHttpServer .CLass); 
component. start(); 


} 


@Get ("json") 
public String getGreeting() { 
return "{\"testResponse\":\"Hello World\"}"; 


} 


6.2.4 Roo 


Roo (http://www.bit.ly/MfMxBL) 让 你 几 分 钟 之 内 就 能 创建 一 个 项 目 。 新 建 的 项 目 运行 在 
一 个 戏 入 的 Jetty (或 Tomcat) 服务 器 上 ， 同 时 还 有 一 个 内 存 数据 库 〈 你 可 以 设计 自己 的 
数据 模型 ， 他 们 能 自动 传递 给 选择 的 数据 库 )。 因 此 不 需要 花费 一 点 时 间 配 置 服务 器 ， 只 
要 在 REPL 上 键入 命令 ， 你 就 能 创建 一 个 包含 Web 服务 器 和 数据 库 的 传统 Web 应 用 。 

















请 下 载 最 新 版 本 的 Roo (http:WVwww.bitly/1dKJ9EN)， 解 压 并 将 roo.sh (或 roo.bat) 加 
入 系统 路 径 。 执 行 roo.sh， 系 统 会 提示 你 完成 初始 化 安装 〈 接 受 许可 协议 )。 随 时 可 输入 
help 或 者 hint 给 出 可 用 选项 的 提示 : 





$ roo.sh 
/SV_ VAN 
/171111171/ 


A /A i NY) 
/NA 人/ 1.2.4.RELEASE [rev 75337cf] 


Welcome to Spring Roo. For assistance press TAB or type "hint" then hit ENTER . 
roo> 





Roo 的 命令 行 像 一 个 创建 基于 Spring 的 Web 应 用 的 专家 系统 。 在 开发 时 ， 可 随时 根据 需 
要 键入 hint 命令 获取 可 用 选项 。 系 统 会 带领 你 建立 数据 存储 、 定 义 实 体 和 成 员 ， 最 终 创 建 
一 个 Web 应 用 。 


需要 注意 的 是 ， 有 时 需要 跳出 命令 行 工 作 。 比 如 ， 如 果 你 键入 错误 的 实体 或 成 员 ， 需 要 将 
它们 从 生成 的 代码 中 删除 时 。 
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在 Roo 中 执行 下 面 一 组 命令 ， 会 创建 一 个 标准 的 包含 JSON 服务 的 JEE Web 应 用 (这 里 省 
略 掉 了 每 条 命令 的 输出 ) : 


project com.saternos.bookshop 
jpa setup --provider HIBERNATE --database HYPERSONIC_IN_MEMORY 


entity jpa --class ~.domain.Author --testAutomatically 
field string --fieldName name --sizeMin 2 --notNull 


entity jpa --class ~.domain.Book --testAutomatically 
field string --fieldName name --notNull --sizeMin 2 
field number --fieldName price --type java.math.BigDecimal 
field set --fieldName authors --type ~.domain.Author 


json all --deepSerialize 
web mvc json setup 
web mvc json all 


web mvc setup 
web mvc all --package ~.web 











该 应 用 对 一 列 图 书 提供 了 CRUD 操作 。 在 项 目 初始 化 后 ， 配 置 了 一 个 内 存 数据 库 ， 然 后 创 
建 了 两 个 实体 (和 对 应 的 成 员 )。 接 下 来 的 三 条 命令 通过 JSON Web API 向 外 暴露 出 实体 ， 
最 后 的 两 条 命令 生成 了 一 个 基于 实体 的 JEE 管理 应 用 。 























该 应 用 构建 后 可 以 运行 在 Jetty 上 : 


mvn clean install jetty:run 


可 以 通过 Curl 调用 JSON API 创建 作者 对 象 ， 第 一 个 例子 展示 了 如 何 创建 一 位 作者 ， 第 二 
个 展示 了 如 何 创建 一 组 作者 。 


curl -i -X POST -H "Content-Type: application/json" \ 
-H "Accept: application/json" \ 

-d '{name: "Simon St. Laurent"}' \ 
http://LocaLhost:8080/bookshop/authors 


curl -i -X POST -H "Content-Type: application/json" \ 

-H "Accept: application/json" \ 

-d '[ {name: "Douglas Crockford"}, {name: "Michael Fogus"} ]' \ 
http://LocaLhost:8080/bookshop/authors/jsonArray 





你 可 以 通过 http:Wlocalhost:8080/bookshop/ 访问 该 应 用 的 主页 ， 该 页 面 拥有 系统 默认 的 专业 
设计 风格 ， 如 攻 0-3 所 示 。 
































ROO 


Spring 








Create new Author | elt /rel 
: Name | 
Listall Authors Simon St. Laurent 怕 ] 四 思 
EE 00 coor 辣 加 四 
Create new Book Michael Fogus 司 网 双 
List all Books BUistresults per page: 5 10 15 20 25 | Page 1 of 1 
Home | Language: Bs | Theme: standard | alt F t F ‘ 








图 6-3; 使 用 Roo 创建 的 Web 应 用 


同样 的 URL， 使 用 HTTP delete 操作 可 以 删除 一 条 记录 : 


CUrL -i -X DELETE -H "Accept: application/json" \ 


http://Llocalhost:8080/bookshop/authors/1 


CUrL -i -X DELETE -H "Accept: application/json" \ 


http://LocaLhost:8080/bookshop/authors/2 


CUrL -i -X DELETE -H "Accept: application/json" \ 


http://LocaLhost:8080/bookshop/authors/3 


可 以 通过 藤 入 作者 的 引用 来 一 起 添加 图 书 连同 其 作者 。 


“List all Books” 页 面 的 变化 : 





curl -i -X POST -H "Content-Type: application/json" \ 


-H "Accept: application/json" \ 
-d names "JavaScript: The Good Parts 
"price:29.99，“ 


` "authors:[{name: "Douglas Crockford"}]}' \ 


http://LocaLhost:8080/bookshop/books 


curl -i -X POST -H "Content-Type: application/json" \ 


-H "Accept: application/json" \ 
本 '"{name:"FunctionaL JavaScript", 
"price:29.99， 
” "authors:[{fname: "Michael Fogus"}]}' \ 
http://LocaLhost:8080/bookshop/books 


curl -i -X POST -H "Content-Type: application/json" \ 





ee 








: 将 代码 格式 化 为 人 们 易 读 的 形式 很 有 挑战 性 。 这 是 


性 
mt 
MD 








为 计算 机 和 人 类 解释 














还 有 本 书 同时 以 纸 质 和 电子 版 出 版 的 事实 。 在 实际 中 
量 也 越 少 越 好 。 遗 憾 的 是 ， 这 样 会 让 页 面 上 的 文字 
会 话 中 ， 长 命令 可 通过 在 每 行 末 尾 输入 反 和 斜 杠 














， 上 述 curl 命令 最 好 没有 换行 ， 而 
自动 换行 显示 错误 或 者 文字 超 上 











管 它 不 是 在 任何 情况 下 都 管用 。 上 述 例子 中 将 JSON 字符 串 划 分 成 多 行 ， 使 用 反 引 号 () : 





ee 格 和 换行 符 。 我 们 利用 bash 这 个 小 技巧 是 为 了 方便 那些 希望 在 本 书 电子 版 上 复制 命令 





图 6-4 展示 了 执行 下 述 Curl 命令 后 





目 空格 的 娄 
页 面 的 边框 。 在 
(\) 分 成 多 行 。 我 们 将 在 本 书 中 沿用 这 种 风格 ， 
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-H "Accept: application/json" \ 
-d '{name:"Introducing Elixir",'. 
“'price:19.99,'. 
“'authors:[{name: "Simon St. Laurent"}]}' \ 
http://LocaLhost:8080/bookshop/books 











[4 
ROO Spring 
Listall Books 
ee [Name Pico Avthos | 
List all Authors 一 
Introducing Erlang 19.99 Simon St Laurent 咎 东 尼 
JavaScript The Good Parts 29.99 Douglas Crockford 徊 加 已 
Create new Book Functional JavaScript 29.99 ”| Michael Fogus 徊 帮 已 
一 一 一 二 Introducing Elixir 19.99 Simon StLaurent 和 四 回忆 








区 UListresults perpage:5101520251Page1of1 





Home |Language: 吕 | Theme: standard | alt 














6-4: 使 用 Roo 创建 的 Web 应 用 
获取 插入 的 作者 和 图 书 列表 : 


curl http://Llocalhost:8080/bookshop/authors 
curl http://LocaLhost:8080/bookshop/books 


可 以 使 用 ID 访问 数组 中 的 一 个 对 象 : 


curl http://LocaLhost:8080/bookshop/books/1 


在 命令 行 中 格式 化 JSON 


有 多 种 对 从 命令 行 返 回 的 JSON 进行 格式 化 的 方法 。 可 以 将 输出 重 定向 到 
一 个 文件 中 ， 然 后 使 用 支持 JSON 格式 化 的 编辑 器 打开 。 还 有 特殊 用 途 的 
工具 ， 比 如 jq (http://stedolan.github.io/jq/)， 可 以 格式 化 通过 管道 传 入 的 
JSON。 如 果 你 安装 了 Python， 格 式 化 就 非常 简单 


curl http://LocaLhost:8080/bookshop/books | python -mjson.tool 


有 了 Web API， 就 可 以 在 使 用 Roo scaffolding 命令 创建 jspx 页 面 的 地 方 创建 (或 增 
加 ) 标准 的 HTML 页 面 。 创 建 一 个 名 为 /src/main/webapp/test.html 的 文件 ， 并 可 以 通过 
http://localhost:8080/bookshop/test.html 访问 它 。 获 取 图 书 列 表 的 GET 操作 可 使 用 jQuery 的 
getJSON 方法 调用 : 














<htmL> 
<head> 
<title>Book List</title> 
<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.10.1/jquery.min.js"> 
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</script> 
</head> 
<body> 


<h3>Books</h3> 
<ul class='booklist'></ul> 
<script> 
(function() { 
$.getJSON('/bookshop/books', function(books) { 
$.each(books, function(nil,book) { 
$('.booklist').append('<li>' + book['name'] + '</\li>'); 


D0O; 
</script> 
</body> 
</htmL> 
因 其 可 交互 的 特性 ，Roo 是 市 面 上 最 易 上 手 的 工具 之 一 。 如 果 你 想 获取 更 多 关于 该 框架 的 
介绍 ， 可 免费 下 载 (http://spring-roo-repository.springsource.org/Getting_Started_with_Roo. 
pdf) Getting Started with Roo (http://shop.oreilly.com/product/0636920020981.do，O’Reilly 
出 版 ) 一 书 ， 而 Spring in Action (http://www.manning.com/rimple/，Manning 出 版 ) 一 书 也 


提供 了 很 多 关于 Roo 的 信息 。 


6.2.5 ”Netty 罕 入 式 服务 器 

Jetty 是 和 Eclipse 基金 会 相关 的 ， 但 JBoss 社区 也 出 现 了 一 个 某 些 功 能 与 其 重合 的 项 目 。 
Netty (http://metty.io/) 被 用 来 创建 优化 网 络 应 用 (服务 器 和 客户 端 协 议 )。 优 化 网 络 应 用 
在 扩展 性 上 比 一 般 应 用 要 好 ，Twitter (https://blog.twitter.com/2011/twitter-search-now-3x- 
faster) 采用 Netty 去 解决 它们 的 性 能 问题 就 表明 了 Netty 的 成 熟 ， 和 其 在 扩展 性 上 的 能 









































使 用 Netty 的 例子 和 前 面 展示 的 使 用 Jetty 的 例子 类 似 ， 它 们 都 遵循 类 似 的 模式 ， 一 个 包含 
main 方法 的 类 初始 化 并 启动 服务 器 ， 一 个 处 理 器 类 负责 处 理 进来 的 请 求 : 








package com.saternos.embedded; 


import io.netty.bootstrap.ServerBootstrap; 
import io.netty.channel.socket.nio.*; 


public class TestNettyHttpServer { 
public static void main(String[] args) throws Exception { 
ServerBootstrap bootstrap = new ServerBootstrap(); 
bootstrap.group(new NioEventLoopGroup(), new NioEventLoopGroup()) 
.Cchannel(NioServerSocketChannel.class) 


.localAddress(Integer .parseInt(args[0])) 
.ChildHandler(new JsonServerInitializer()); 
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处 至 





EE 如 类 继承 


System.out.println("Starting server on port: " + args[0]); 


bootstrap.bind().sync().channel().closeFuture().sync(); 





自 ChannelInboundMessageHandlerAdapter， 该 类 被 包含 在 服务 器 的 管道 





Kt 
o 





messageReceived 方法 拿 到 请 求 并 创建 响应 : 





package com.saternos.embedded; 


import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


io.netty.buffer .Unpooled; 
io.netty.channel.*; 
io.netty.handler.codec.http.*; 
io.netty.util.CharsetUtil; 


java. 
java. 
java. 
java. 
java. 


text.SimpleDateFormat; 
util.Calendar; 
util.GregorianCalendar; 
util.Locale; 
util.TimeZone; 


class JsonHandler extends ChannelInboundMessageHandlerAdapter<HttpRequest> { 


public void messageReceived(ChannelHandlerContext channelHandlerContext, 


HttpRequest httpRequest) throws Exception { 


StringBuffer buf = new StringBuffer(); 
buf.append("{\"testResponse\":\"Hello World\"}"); 


SimpleDateFormat dateFormatter = new SimpleDateFormat( 


"EEE, dd MMM yyyy HH:mm:ss zzz", 
Locale.US 
); 
dateFormatter .setTimeZone(TimeZone.getTimeZone("GMT")); 
Calendar time = new GregorianCalendar(); 


HttpResponse response = new DefaultHttpResponse(HttpVersion.HTTP_1_1, 


HttpResponseStatus .OK); 


response.setHeader (HttpHeaders.Names .CONTENT_TYPE, 


"application/json;charset=utf-8"); 


response.setHeader (HttpHeaders.Names .CONTENT_LENGTH, buf.length()); 
response.setHeader (HttpHeaders.Names .DATE, 


dateFormatter .format(time.getTime())); 


response.setHeader (HttpHeaders .Names .SERVER, 


TestNettyHttpServer.class.getName() + 
":io.netty:netty:4.0.0.Alpha8"); 


response.setContent(Unpooled.copiedBuffer(buf, CharsetUtil.UTF_8)); 
channelHandlerContext.write(response).addListener( 


} 





ChannelFutureListener .CLOSE); 


有 还 需要 一 个 实现 ChannelInitializer 接口 的 类 来 建立 管道 。 














initChannel 方 法 引用 了 Channel 接口 (http://netty.io/4.0/api/)， 它 被 用 来 创建 和 访问 / 
SocketChannel ((http://netty.io/4.0/api)) 管道 。 管 道 转换 或 更 改 传 进来 的 值 。HttpRequestDecoder 
(http://netty.io/4.0/api/io/netty/handler/codec/http/HttpRequestDecoder.html) 接收 原始 字 节 ， 
并 用 它们 构建 HITP 相关 的 对 象 ，HttpChunkAggregator 使 用 分 块 传输 编码 方式 归 一 化 请 
求 。 随 后 的 两 个 管道 类 对 响应 进行 编码 和 分 块 ， 然 后 传递 给 实例 应 用 具体 的 处 理 器 类 (这 
里 生成 头 信息 和 实际 的 响应 ) : 


























package com.saternos.embedded; 


import io.netty.channel.*; 

import io.netty.channel.socket.SocketChannel; 
import io.netty.handler.codec.http.*; 

import io.netty.handler.stream.ChunkedWriteHandler; 


public class JsonServerInitializer extends ChannelInitializer<SocketChannel> { 


public void initChannel(SocketChannel socketChannel) throws Exception { 
ChanneLPipeLine pipeline = socketChannel.pipeline(); 
pipeline.addLast("decoder", new HttpRequestDecoder()); 
pipeline.addLast("aggregator", new HttpChunkAggregator(65536)); 
pipeline.addLast("encoder", new HttpResponseEncoder()); 
pipeline.addLast("chunkedWriter", new ChunkedwriteHandler()); 
pipeline.addLast("handler", new JsonHandler()); 


} 
构建 和 执行 上 述 应 用 会 得 到 和 前 一 个 例子 类 似 的 响应 : 





$ gradle build startServer 
$ curl -i http://localhost:8000 


HTTP/1.1 200 OK 

Content-Type: application/json;charset=utf-8 

Content-Length: 30 

Date: Fri, 14 Jun 2013 14:02:57 GMT 

Server: com.saternos.embedded.TestNettyHttpServer:io.netty:netty:4.0.0.Alpha8 


{"testResponse":"Hello World"} 














Netty 是 一 个 相对 底层 、 通 用 的 网 络 类 库 。 这 为 创建 优化 应 用 提供 了 很 多 灵活 性 ， 其 代价 
是 要 建立 额外 的 管道 和 处 理 器 。 上 述 例子 有 点 长 ， 而 且 也 更 复杂 ， 但 是 理解 它 是 值得 的 ， 
为 Netty 是 其 他 几 个 高 级 框架 ， 比 如 Play 和 Vertx 的 基础 。Norman Maurer 是 Netty 的 
核心 开发 者 之 一 ， 他 编写 了 Netty in Action (http://www.manning.com/maurer/，Manning 出 
版 ) 一 书 ， 该 书 深入 阐述 了 这 个 复杂 框架 的 功能 细 市 。 






























































6.2.6 ”Play 服务 器 


Play 框架 (http://www.playframework.org/) 是 一 个 轻 量 级 、 无 状态 的 框架 ， 非 常 适 合 创 建 
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服务 器 API。 使 用 一 些 简单 的 命令 就 能 生成 一 个 Play 应 用 ， 路 由 文件 指明 了 HTTP 操作 和 

引用 控制 器 方法 的 路 径 。 代 码 可 以 使 用 Java 或 Scala 编写 ， 其 中 来 自 Scala 社区 的 印记 随 

处 可 见 ， 比 如 使 用 SBT 和 基于 Scala 的 模板 。 对 Play 项 目的 更 改 会 立即 反映 在 浏览 器 中 ， 
不 需要 再 单独 构建 。 

















安装 好 Play (https:/www.playframework.com/documentation/2.1.1/Installing) 后 ， 使 用 play 
new 创建 一 个 新 的 Play 应 用 ， 给 应 用 起 个 名 字 ， 选 择 一 个 Java 模板 : 








$ play new play-server 


| -AN 1 III 
Dt A A ls ne 
|_| |_/ 

play! 2.1.1 (using Java 1.7.0_21 and Scala 2.10.0), http://www.playframework.org 


The new application will be created in /Users/cs/Desktop/tmp/play-server 


What is the application name? [play-server] 
> 


Which template do you want to use for this new application? 


1 - Create a simple Scala application 
2 - Create a simple Java application 
>2 


OK, application play-server is created. 


Have fun! 





该 命令 生成 的 应 用 结构 和 Ruby on Rails 应 用 相仿 。 后 续 的 命令 和 修改 文件 操作 都 在 新 建 目 
录 下 : 


cd play-server 





在 这 个 例子 中 ， 给 定 一 个 URL (/json) ， 该 应 用 返回 JSON。 修 改 conf/routes， 为 其 加 入 
下 面 一 行 来 定义 该 API: 

















GET /json controllers.Application.json() 


后 ， 修 改 路 由 文件 中 引用 的 Java 控制 器 代码 。 





需要 注意 的 是 ， 区 别 于 之 前 通过 JSON 字符 串 返 回 一 个 “Hello World ”的 例子 ， 该 例子 中 
它 创 建 了 一 个 对 象 ， 在 响应 中 将 其 序列 化 为 JSON (底层 使 用 了 Jackson) 。 





在 JAX-RS (JEE Java API for RESTful) Web 服务 中 也 用 到 了 这 种 创建 对 象 ， 然 后 在 响应 
中 将 其 序列 化 为 目标 格式 的 流程 : 








package controllers; 


import play.*; 

import play.mvc.*; 

import views.html.*; 

import org.codehaus.jackson.JsonNode; 

import play.libs.Json; 

import org.codehaus.jackson.node.0bjectNode; 
import org.codehaus.jackson.node.ArrayNode; 
// 优化 打印 

import org.codehaus.jackson.map.0bjectMapper; 
public class Application extends Controller { 


public static Result index() { 


} 


return ok(index.render("Your new application is ready.")); 


public static Result json() { 


ObjectNode result = Json.newObject(); 


// 如 何 虑 套 JSON 对 象 

ObjectNode child = Json.newObject(); 
child.put("color", "blue"); 
resuLt.put("Nested0bj" ,chiLd); 





ny 


// 添加 字符 
result.put("status", "OK"); 
result.put("something", "else"); 


// 添加 整数 
result.put("int", 1); 


// 添加 JSON 数 组 
ArrayNode collection = result.putArray("coll"); 
collection.add(1); 
collection.add(2); 
collection.add(3); 
collection.add(4); 


// 注释 掉 这 行 -VVV- 并 去 掉 下 面 /* */ 的 注释 格式 化 JSON 


/* 





return ok(result); 


// 为 了 返回 打印 良好 的 JSON ,需要 将 字符 串 格式 化 ,然后 显 式 地 设置 响应 
// http://www.playframework.com/documentation/2.1.0/JavaResponse 


// 
// 





ObjectMapper mapper = new ObjectMapper(); 


String s=""; 
tryt 
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5 = mapper.defaultPrettyPrintingWriter().writeValueAsString(result); 
Jcatch(Exception e){} 
return ok(s).as("application/json"); 
* 


} 
} 








可 以 在 应 用 所 在 目录 启动 内 置 的 服务 器 : 
$ play ~run 
可 以 删 掉 下 述 代码 : 


return ok(result); 











代 之 以 紧 跟 其 后 的 代码 ， 刷 新 浏览 器 就 能 看 到 输出 的 JSON 被 格式 化 了 。 











不 需要 刷新 浏览 
使 用 James Ward (https://github.com/jamesward/play-auto-refresh) 开发 的 Chrome 插件， 
浏览 器 都 不 需要 刷新 。 每 当 保 存 文件 时 ， 浏 览 器 会 自动 刷新 。 安 装 Play Chrome 播 件 
(https://chrome.google.com/webstore/detail/play-framework-tools/dchhggpgbommpcjpogapl 
oblnpldbmen) ， 修 改 project/plugins.sbt， 为 其 添加 下 面 一 行 : 


addSbtPlugin("com.jamesward" %% "play-auto-refresh" % "0.0.3") 











6.2.7 ”其 他 轻 量 级 服务 器 


以 上 并 不 是 所 有 构建 API 的 选择 ，Dropwizard (https://dropwizard.github.io/dropwizard/) 
是 一 个 开发 HTTP/JSON Web 服务 的 Java 框架 (和 Restlet 功能 类 似 ) 。 它 基于 其 他 最 佳 技 
术 组 合 (HTTP 使 用 Jetty、JSON 使 用 Jackson、REST 使 用 Jersey)。 无 容器 和 最 小 化 髓 
入 式 的 服务 器 对 Java 社区 来 说 还 有 点 新 鲜 ， 但 来 自 其 他 语言 的 程序 员 早已 把 这 当成 理 所 
当然 的 了 。 


6.3 ”基于 JVM 的 服务 器 


除了 使 用 Java 的 选项 ，JVM 也 可 以 作为 其 他 语言 的 编译 目标 。 每 次 发 布 Java， 都 会 增加 
对 基于 JVM 的 语言 的 支持 。 事 实 上 ， 前 面 介绍 的 Play 框架 将 Scala 作为 其 优先 使 用 的 语 
言 。 如 果 你 对 基于 JVM 的 语言 的 表达 能 力 感 兴趣 ，Vert.x (http://vertx.io/) 这 个 Web 服务 
器 允许 使 用 JavaScript、CoffeeScript、Ruby、Python、Groovy 和 Java 开发 应 用 。 



















































































可 以 在 Java 应 用 中 调用 基于 JVM 的 语言 ， 一 个 项 目 也 可 以 使 用 一 个 Java 类 作为 其 语言 能 
解释 器 。 下 面 的 代码 片段 展示 了 如 何 创 建 在 JVM 上 运行 的 简单 服务 器 。 
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Jython 
如 果 你 已 经 安装 好 Python， 使 用 下 述 命令 启动 一 个 Web 服务 器 共享 当前 目录 下 的 文件 : 
$ python -m SimpleHTTPServer 8000 


Jython 是 Python 在 JVM 上 的 实现 ， 多 花 一 点 儿 力气 就 能 完成 类 似 的 功能 。 创 建 build. 
gradle 文件 ， 其 中 一 个 任务 启动 Jython， 调 用 一 个 Python 脚本 启动 HTTP 服务 器 : 














apply plugin:'java' 


repositories{mavenCentral()} 
dependencies{compile 'org.python:jython-standalone:2.5.3'} 


// 运行 J]ython 服 务 器 的 例子 

task(startServer, dependsOn: 'classes', type: JavaExec) { 
main = 'org.python.utiL.jython' 
classpath = sourceSets.main.runtimeClasspath 
args "http_server.py" 


} 
http_server.py 包含 切换 到 共享 文件 目录 ， 创 建 并 启动 服务 器 的 代码 : 


import SimpLeHTTPServer 
import SocketServer 
import os 


os.chdir('root') 

print "serving at port 8000" 

SocketServer.TCPServer(("", 8000), 

SimpleHTTPServer .SimpleHTTPRequestHandler).serve_forever() 


创建 一 个 名 为 root 的 文件 夹 ， 所 有 在 root 文件 夹 里 的 文件 都 将 通过 SimpleHTTPServer 共 
享 。 以 .json 为 后 级 的 文件 其 内 容 类 型 是 application/json。 








模拟 服务 器 的 最 快 方式 














有 了 这 个 简单 的 配置 ， 客 户 端 开发 者 在 服务 端 代码 还 未 完成 时 就 能 开始 编 
写 客户 端 代码 。 通 过 创建 和 API 路 径 相仿 的 文件 目录 ， 就 能 模拟 JSON 响 
应 。 这 些 JSON 响应 文件 可 当 作 API 文档 ， 也 可 以 验证 服务 器 端 代码 的 单 
元 测试 。 


6.4 Web 应 用 服务 器 


当然 ， 还 有 完整 的 Web 应 用 服务 器 方案 ， 用 来 部 署 通过 Java、Python (使 用 django-jython， 
参见 http://pythonhosted.org/django-jython/war-deployment.html) 或 Ruby (使 用 warbler， 参 


乡 
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见 https://github.com/jruby/warbler) 开发 的 产品 代码 。Tomcat 是 一 个 Servlet 容器 (前 面 提 
到 的 Roo 框架 就 使 用 它 )， 因 此 任何 Web 应 用 都 可 以 部 署 成 一 个 WAR 包 在 其 中 运行 。 包 
含 一 组 WAR 包 的 项 目 需 要 被 打包 成 EAR (或 者 单独 的 WAR 包 需 要 某 些 JEE 服务 )， 此 
时 就 需要 一 个 完整 的 JEE 应 用 服务 器 ， 比 如 JBoss。 


6.5 ”如 何在 开发 中 使 用 


客户 端 和 服务 器 端的 分 离 为 客户 端 开发 提供 了 多 种 可 能 ， 使 用 快速 建立 的 服务 器 ， 让 服 
务 器 端 得 以 并 行 工 作 。 最 基本 的 是 ， 只 要 创建 一 个 HTTP 服务 器 ， 就 可 以 返回 硬 编码 的 
JSON。 再 花 点 工夫 ， 就 可 以 将 JSON 保存 到 文件 系统 中 ， 文 件 名 对 应 着 API URL。 如 果 
需要 访问 数据 库 ，Roo 包含 了 方便 的 数据 库 集 成 功能 ， 其 他 基于 Java 的 项 目 也 提供 了 该 技 
术 。 服 务 器 端的 功能 还 可 进一步 扩展 ， 包 含 不 同 的 数据 源 、 应 用 缓存 和 其 他 一 些 作为 生产 
服务 器 的 基础 功能 。 如 果 一 个 大 型 应 用 没有 明确 地 划分 客户 端 和 服务 器 端 ， 就 不 可 能 使 用 
这 种 开发 方式 。 















































6.6 小结 


本 章 的 例子 突出 了 服务 器 端 开发 方式 的 渐进 简化 ， 与 之 形成 对 比 的 是 客户 端 代码 不 断 增长 
的 复杂 性 。Java 开发 者 进入 了 一 个 与 传统 打包 方式 不 同 的 世界 ， 应 用 服务 器 的 部 署 需要 知 
道 这 种 替代 方案 以 更 好 地 适应 客户 端 - 服务 器 端 模型 。 


不 必 深 入 网 络 细节 和 低级 语言 ， 你 也 可 以 创建 一 个 轻 量 级 、 专 用 的 API 或 HTTP 服务 器 。 
简单 、 轻 量 级 的 服务 器 端 代码 和 简化 的 部 署 选 项 源 自 于 对 创建 高 扩展 性 方案 的 需求 ， 这 在 
大 规模 部 署 时 被 证 明 非 常 实用 。 这 种 迁移 对 程序 员 的 日 常 工作 流程 影响 深远 ， 这 些 影响 
(大 多 数 时 候 都 是 积极 的 ) 正 是 下 一 章 要 讲解 的 主题 。 


























“在 一 身 话 中 找寻 我 的 家 ,一 个 简洁 的 向 子 ， 犹 如 金属 锻造 。 
并 非 为 了 迷惑 什么 人 。 并 非 为 了 在 后 代 之 中 获取 永恒 的 声名 。 
一 个 未 命名 的 事物 需要 秩序 、 前 律 、 形 式 ， 这 三 个 词 反 对 混乱 和 虚无 。” 
一 一 切 斯 拉夫 。 米 沃 什 


7.1 开发 者 的 生产 率 

简洁 、 高 效 、 简 单 ， 是 当代 文化 所 高 度 推崇 的 。 或 许 这 是 因为 和 以 前 相 比 ， 现 代 社会 变 得 
相对 丰富 和 复杂 了 。 代 码 简洁 、 流 程 高 效 的 Web 应 用 会 让 最 终 产 品 易于 维护 、 易 于 修改 ， 
最 终 会 帮助 获取 更 高 的 利润 。 同 样 ， 程 序 员 的 工作 流程 和 工具 也 应 该 高 效 ， 避 免 无谓 的 复 
杂 。 由 于 选择 太 多 ， 开 发 者 暂时 从 编码 中 抽身 ， 认 真 思考 一 下 工作 流程 是 否 优化 、 是 否 高 
效 ， 就 变 得 特别 重要 了 。 


随 着 Web 开发 方式 向 客户 端 一 服务 器 端 架 构 的 转变 ， 开 发 流程 也 面临 不 断 的 改变 和 提高 。 
通过 去 掉 很 少 用 到 的 配置 选项 、 使 用 合理 的 缺 省 值 ， 减 少 了 大 量 不 必要 的 工作 。 简 化 的 工 
作 流 程 带 来 更 紧 竣 及 时 的 反馈 循环 ， 频 繁 的 反馈 让 人 及 时 发 现 和 解决 产品 中 的 问题 。 及 早 
发 现 和 修复 缺陷 提高 了 生产 效率 一 一 也 让 程序 员 更 加 开心 。 更 进一步 说 ， 它 让 原本 需要 大 
量 时 间 和 资源 才能 开发 维护 的 复杂 且 高 质量 的 软件 ， 现 在 有 可 能 花费 较 少 的 时 间 和 资源 就 
能 做 到 。 
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大 多 草草 了 事 …… 


众所周知 ， 衡 量程 序 员 的 生产 效率 很 难 。 工 作 时 间 、 每 日 代码 量 或 者 解决 的 
缺陷 数目 ， 这 样 的 指标 虽然 可 量化 ， 但 不 是 很 有 用 。 由 于 项 目的 目标 、 时 间 
和 其 预期 寿命 的 不 同 ， 很 难 对 它们 做 比较 。 没 有 一 个 指标 能 适用 于 所 有 项 
目 ， 足 够 客观 、 公 正 ， 准 确 地 反映 出 程序 员 的 工作 效率 。 在 实践 中 ， 大 多 数 
软件 开发 经 理 根 据 开发 者 给 出 的 估计 和 实际 产 出 , “艺术 地 ”维护 着 一 张 电 
子 表格 以 准确 估计 这 两 者 之 间 的 关联 度 。 这 样 就 能 理解 ， 为 什么 通过 改进 流 
程 会 提升 个 人 和 组 织 的 效率 这 个 假设 会 被 大 家 所 接受 了 。 












































敏捷 开发 最 早 是 以 纠正 课 布 式 开发 的 缺陷 的 形式 出 现 的 ， 瀑 布 式 开发 倾向 于 一 开始 就 负重 
前 行 ， 花 费 大 量 精力 ， 组 织 大 量 活动 ， 项 目 反而 不 会 取得 有 意义 的 进展 。 这 种 趋势 再 发 展 
就 是 “分 析 瘫 病 " ， 当 敏捷 开发 被 初次 引入 时 ， 其 立即 着 手 开发 一 个 可 工作 的 产品 的 观点 
令 人 人 耳目一新。 遗憾 的 是 ， 随 着 时 间 的 推移 ， 这 一 概念 被 发 展 成 为 一 种 “做 了 再 说 ”的 方 
式 ， 早 期 的 很 多 活动 都 没有 一 个 定义 清晰 的 目标 。 因 此 ， 如 果 想 要 生产 提高 效率 需要 ， 可 
能 这 样 说 有 违 直觉 ， 需 要 先 放下 工作 。 显 然 ， 这 不 是 指 让 你 真 的 放下 工作 ， 这 是 为 了 项 目 
的 质量 和 长 期 生产 效率 ， 而 对 暂时 的 衡量 指标 和 可 见 进度 做 出 牺牲 的 能 














这 样 做 很 有 挑战 性 。 管 理 层 希 望 看 见 手头 的 项 目 进 展 ， 开 发 者 喜欢 编写 代码 ， 客 户 希 望 看 
到 前 者 真 的 着 手 开始 工作 了 。 但 是 过 早 开始 可 能 会 导致 工具 和 开发 方式 选 型 错误 (或 者 不 
是 最 理想 的 )。 将 不 适用 的 约定 或 传统 引入 项 目 遗 害 无 穷 。 早 期 的 一 点 点 偏差 ， 都 会 让 项 
目 偏离 正确 的 轨道 ， 随 着 项 目的 进展 ， 问 题 会 越 积 越 多 。 认 识 到 暂时 放下 工作 ， 先 做 一 些 
分 析 ， 会 让 工作 效率 更 高 ， 产 品质 量 更 高 ， 这 是 需要 一 些 远 见 的 。 




















预先 分 析 因 为 采用 伪 敏 捷 开发 (pseudo-agile) 而 饱 受 诉 病 〈“ 伪 ” 字 是 指 这 里 所 讲 的 并 不 
违背 敏捷 开发 实践 )。 几 事 要 三 思 而 后 行 ， 这 适用 于 多 个 层面 。 开 发 团队 领导 者 需要 做 出 
项 目 相关 的 决定 ， 每 一 个 开发 者 需要 了 解 最 佳 实践 和 新 兴 技 术 ， 这 对 他 们 的 手头 工作 可 能 
有 用 。 有 了 正确 的 工具 和 方法 ， 会 减少 完成 初始 工作 的 时 间 和 精力 ， 如 有 果 做 对 了 ， 从 长 远 
看 会 开发 出 一 套 简单 、 易 于 维护 的 系统 。 不 可 将 全 部 精力 和 注意 力 放 在 最 紧急 的 任务 上 ， 
而 应 做 出 根本 性 调整 以 高 效 地 工作 。 在 项 目 中 可 以 采用 敏捷 开发 中 欢迎 变化 的 方式 ， 但 基 
础 的 技术 决策 和 相关 开发 流程 不 应 有 大 的 改动 。 























避免 孤立 地 看 待 生产 效率 


显而易见 ， 只 关注 生产 效率 是 不 够 的 。 如 果 绝 对 扳 立 地 看 待 生产 效率 ， 什 么 
也 不 做 或 许 是 最 好 的 选择 ! 软件 质量 、 可 靠 性 、 流 畅 的 交流 、 功 能 的 正确 
性 、 对 流程 的 遵守 和 约定 俗 成 的 规则 同样 重要 。 假 设 其 他 条 件 一 样 ， 最 好 能 
用 最 少 的 动作 、 最 少 的 资源 完成 一 件 任务 。 因 此 ， 任 何以 提高 生产 效率 为 名 
义 ， 对 流程 的 改变 ， 都 应 该 放 在 一 个 更 广阔 的 视野 下 来 审视 。 而 且 ， 一 个 真 
正高 效 的 流程 也 同样 强调 质量 、 可 靠 性 和 其 他 重要 的 因素 。 
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没有 一 个 简单 的 计划 或 者 理论 会 马上 提高 生产 效率 ， 这 多 少 有 点 让 人 失望 。 真 正 能 提高 生 
产 效 率 的 东西 都 是 在 实践 中 ， 在 具体 的 项 目 中 变 干 边 学 ， 发 现 和 制定 的 。 先 把 工作 完成 ， 
日 复 一 日 ， 就 看 出 了 流程 什么 地 方 需要 完善 ， 完 善 它 ， 这 样 周而复始 。 这 些 积攒 下 来 的 知 




















识 ， 会 成 为 在 其 他 项 目 中 提高 、 优 化 流程 和 去 除 不 合理 之 处 的 源 录 。 




















理论 上 说 ， 一 个 软件 项 目 需要 完成 若干 任务 ， 因 此 在 理想 情况 下 会 尽 可 能 以 最 高 效 的 方式 
完成 。 划 分 成 任务 后 ， 更 容易 理解 和 衡量 生产 效率 。 每 一 项 软件 开发 任务 都 需要 若干 人 ， 
使 用 若干 台电 脑 完 成 。 在 做 项 目 时 ， 人 与 计算 机 ， 人 与 人 ， 计 算 机 与 计算 机 之 间 可 进行 交 





























互 。 所 有 这 些 ， 从 地 理 上 看 可 能 分 布 在 不 同 地 方 ， 如 图 7-1 所 示 。 

















图 7-1: 人 与 计算 机 的 交互 
考虑 到 这 一 点 ， 就 可 以 在 如 下 交互 之 间 提 高 生产 效率 : 


。 人 与 人 ， 
。 计算 机 与 计算 机 ， 
。 人 与 计算 机 。 


人 和 计算 机 是 完成 一 项 任务 所 需要 的 资源 ， 如 表 7-1 所 示 。 为 了 提高 生产 效率 ， 需 要 : 





。 重新 定义 任务 ， 

。 提高 (给 定 资源 或 资源 之 间 交 互 的 ) 效率 ， 

。 增加 资源 ; 

。 花费 更 多 精力 (通过 加 班 让 单位 资源 的 产 出 更 高 )。 


表 7-1: 能 提高 生产 效率 的 地 方 























行动 人 计算 机 

重新 定义 任务 确定 需求 、 计 划 、 架 构 和 管理 编程 语言 、 软 件 和 编程 范式 

提高 效率 开发 技术 、 最 小 化 干扰 自动 化 、 预 处 理 、 压 缩 、 优 化 、 调 优 
增加 资源 开发 者 、 顾 问 扩展 、 增 加 硬件 /处 理 器 

花费 更 多 精力 时 间 管 理 、 调 整 工作 量 并 行 处 理 





认识 到 这 些 地 方 的 重要 性 的 理由 很 多 。 在 某 个 地 方 没有 提高 生产 效率 〈 比 如 最 近 一 段 时 期 

















在 计算 机 领域 没有 重大 的 技术 创新 )， 会 影响 到 人 的 生产 效率 〈 通 过 加 班 或 增加 人 手 )。 想 





一 下 这 些 因素 和 项 目的 关系 能 帮助 人 们 有 效 地 行动 起 来 ， 可 能 花费 相对 较 小 的 代价 就 能 带 
来 显著 的 提升 。 


这 种 全 盘 考虑 的 方式 ， 能 避免 过 份 强 调 某 一 方面 ， 去 解决 所 有 问题 。 一 个 大 家 都 知道 的 例 
子 是 在 项 目 后 期 ， 费 希望 于 增加 工作 量 和 人 和 手 来 赶 一 个 太 具 有 野心 的 最 后 期 限 。 另 一 个 例 
子 古 自 大 的 开发 者 陷阱 ， 他 们 认为 不 管 任务 的 性 质 如 何 ， 都 可 以 闭门造车 ， 让 其 自动 化 。 
本 书 强调 的 重点 放 在 计算 机 上 。 


7.2 优化 开发 者 和 团队 的 工作 流程 

迭代 是 一 种 向 着 最 终 目标 迈进 (最终 实 现 目标 )、 不 断 循环 的 过 程 。 项 目的 每 一 部 分 都 被 
分 解 成 任务 ， 经 过 多 次 选 代 完成 ， 如 图 7-2 所 示 。 这 种 方式 适用 于 软件 开发 的 方方面面 ， 
包括 需求 收集 、 设 计 、 开 发、 测试 和 部 署 。 



























































图 7-2: 项 目 迭 代 
你 需要 将 如 下 几 条 谨 记 在 心 。 


迭代 需要 以 一 种 可 见 成 果 作为 终结 。 和 迭代 完成 后 的 结果 需 能 与 上 一 个 迭代 的 状态 ， 和 最 终 
希望 的 结果 做 比较 。 如 果 结 果 是 不 可 见 的 ， 就 说 明 有 问题 了 。 可 见 的 东西 才能 度量 和 提 
高 。 不 可 见 的 东西 无 法 衡量 、 修 复 和 提高 。 从 这 个 意义 上 来 说 ， 可 将 迭代 看 作 一 种 反馈 循 
环 ， 以 行动 开始 ， 以 可 衡量 的 响应 结束 。 





























迄 代 (或 反馈 循环 ) 可 大 可 小 。 开 发 者 对 某 段 代码 的 细微 改动 可 看 作 一 个 小 的 迭代 ， 而 最 
终 发 布 的 一 套 完 整 的 大 型 系统 则 是 一 个 相对 较 大 的 和 迭代。 部 署 后 的 反馈 可 基于 自动 化 ， 也 
可 人 工 处 理 。 自 动 化 的 反馈 能 提供 一 个 大 概 的 信息 ， 显 示 系 统 是 否 如 预期 的 那样 运转 正 
常 。 但 是 ， 自 动 化 代替 不 了 真实 用 户 的 反馈 。 


短 周期 迁 代 能 得 到 更 多 的 反馈 。 更 多 的 反馈 意味 着 看 得 更 多 。 和 获取 更 多 反馈 的 原因 很 多 。 
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它 能 快速 定位 问题 (或 者 机 会 ) ， 更 容易 在 项 目 早期 纠正 方向 性 的 错误 。 循 环 的 周期 越 短 ， 
就 越 能 及 时 得 到 反馈 ， 效 果 就 会 越 好 。 


从 本 质 上 来 说 ， 和 迭代 中 的 每 一 点 进展 都 会 让 整个 项 目 取 得 进展 ， 因 为 迭代 是 不 断 重复 进行 
的 。 如 何 发 现 那些 迭代 中 不 断 重 复 的 任务 ， 并 且 改 进 那些 对 整个 项 目 影响 最 大 的 任务 ， 是 
一 个 挑战 。 


对 项 目 中 任何 一 项 任务 而 言 ， 优 化 都 是 值得 的 。 对 那些 重复 多 次 的 任务 做 优化 ， 好 处 更 
多 。 如 有 可 能 ， 应 尽力 将 任务 自动 化 处 理 。 与 其 “好 好 干 "， 不 如 减少 那些 不 必要 的 任务 ， 
这 听 起 来 看 可 能 有 违 直 觉 ， 但 事实 却 是 如 此 。 























这 些 都 显而易见 ， 是 简单 的 常识 。 但 正如 那些 涉猎 软件 开发 的 人 所 看 到 的 ， 开 发 者 是 习惯 
的 生物 。 很 多 人 都 习惯 了 某 种 开发 流程 或 某 些 工具 。 这 会 导致 大 量 不 必要 的 工作 ， 让 项 目 
复杂 化 ， 最 多 只 能 得 到 次 优 的 结果 。 





























越 快 越 好 

Boyd 认为 赢得 空中 格斗 的 决定 性 因素 不 是 观察 、 分 析 、 计 划 、 更 好 的 实施 ， 而 是 观 
察 、 分 析 、 计 划 和 更 快 的 实施 。 换 向 话说 ， 主 要 看 一 个 人 能 选 代 多 快 。Boyd 认为 迁 代 
速度 胜 过 迁 代 质量 。 
我 将 Boyd 的 发 现 称 为 Boyd 选 代 定律 : 在 应 对 复杂 分 析 时 ， 快 速 选 代 几 乎 总 是 优 于 深 
入 分 析 。 

一 一 Roger Sessions, “A Better Path to Enterprise Architectures” 

(https://msdn.microsoft.com/en-us/library/aa479371.aspx ) 











我 们 中 的 大 多 数 人 都 无 缘 发 明 什 么 重大 创新 ， 给 软件 开发 流程 带 来 革命 性 的 改变 。 但 是 跳 
出 自己 的 编程 文化 至 少 可 以 开 开 眼界 ， 有 很 多 现成 的 改进 可 供 使 用 ， 这 入 研究 那些 成 熟 技 
术 ， 可 以 让 个 人 获 益 良 多 ， 更 不 用 提 对 项 目的 帮助 了 。 让 我 们 通过 几 个 例子 来 看 看 。 























7.2.1 例子 : 修复 Web 应 用 

现在 需要 修改 一 个 JEE Web 应 用 (由 一 个 包含 多 个 WAR 的 EAR 构成 )， 该 应 用 使 用 
Maven 构建 ， 部 署 在 JBoss 应 用 服务 器 上 。 负 责 修改 的 开发 者 需要 对 代码 做 几 处 改动 (在 
这 个 过 程 中 或 多 或 少 会 犯 点 错误 )。 解 决 该 问题 有 一 种 方法 ， 需 要 下 面 几 步 。 首 先 ， 修 改 
人 代码。 其次， 键入 命令 启动 一 个 标准 的 完全 构建 ， 然 后 部 署 该 应 用 。 根 据 应 用 的 规模 、 单 
元 测试 的 数量 、 构 建 过 程 和 其 他 因素 ， 完 成 第 二 步 也 许 要 花 上 几 分 钟 。 让 我 们 看 看 怎样 做 
能 改善 该 流程 。 


首先 ， 有 很 多 Shell 命令 可 用 ， 最 先 想到 的 是 命令 行 历史 (和 搜索 )。 



























































构建 中 的 每 一 步 是 否 都 需要 执行 。 比 如 ， 在 Maven 中 ， 使 用 -DskiptTests 参数 可 显著 缩 
短 构建 时 间 。 


是 否 需要 一 次 完整 的 部 署 。 或 许 不 需要 一 次 完整 的 构建 来 测试 改动 ， 可 以 热 部 署 改动 
代码 。 


改动 是 否 需要 一 个 初始 的 部 署 环境 。 初 始 的 测试 也 许可 以 在 浏览 器 里 完成 (如 果 改 动 主要 
涉及 HTML、CSS 和 JavaScript)。 对 于 服务 器 端的 代码 ， 可 以 连 上 远程 调试 器 ， 在 上 下 文 
环境 中 观测 相关 的 对 象 和 变量 ， 可 能 这 就 足以 发 现 问题 ， 避 免 不 必 要 的 迭代 。Java 代码 可 
以 脱离 完整 的 部 署 环境 ， 用 单元 测试 验证 其 正确 性 (这 表明 了 测试 驱动 开发 可 以 提高 生产 


效率 )。 
































7.2.2 例子: 测试 集成 
这 个 例子 还 是 围绕 上 面 项 目的 ， 但 进展 顺利 。 人 们 一 致 认为 应 该 加 入 测试 ， 作 为 软件 开发 
生命 周期 的 一 部 分 。 这 可 以 发 生 在 软件 开发 的 各 个 阶段 和 层次 。 

















测试 人 员 和 开发 人 员 可 以 结对 测试 ， 验 证 最 初 的 需求 是 否 和 实现 匹配 ， 但 是 人 很 难保 持 
致 ， 或 者 穷尽 所 有 场景 。 


创建 (使 用 JUnit) 单元 测试 。 单 元 测试 能 更 全 面 地 测试 ， 但 如 果 不 能 持续 运行 ， 效 果 就 
大 打折 扣 了 。 


将 单元 测试 集成 进 Maven 构建 中 。 在 一 台 持 续集 成 服务 器 上 构建 ， 如 果 有 代码 变更 破坏 了 
构建 ， 开 发 者 会 立即 受到 警告 。 然 而 这 还 是 无 法 说 明 测 试 覆盖 范 围 有 多 广 ， 价 值 有 多 大 。 












































单元 测试 覆盖 率 报告 能 给 出 代码 覆盖 率 的 情况 。 但 是 测试 集中 于 服务 器 端 ， 当 项 目 中 浏览 
器 端的 代码 占 大 头 时 ， 这 就 成 了 一 个 问题 。 


幸运 的 是 ， 足 智 多 谋 的 前 端 开 发 工程 师 已 经 开始 使 用 Jasmine 来 做 单元 测试 。 使 用 一 个 插 
件 ， 就 能 将 其 集成 进 Maven 构建 中 。 而 且 ，JavaScript 开发 者 可 以 使 用 在 自己 的 工作 站 上 
安装 Karma， 用 它 来 运行 客户 端 代码 的 单元 测试 。 


随 着 项 目的 进展 ， 工 作 流 程 也 趋 于 稳定 ， 此 时 就 可 以 编写 功能 测试 来 反映 用 户 的 使 用 体 
验 。 使 用 Selenium 可 以 在 各 种 浏览 器 上 运行 功能 测试 。 


这 种 测试 场景 将 关注 点 放 在 如 何 增加 对 项 目 状态 的 反馈 ， 而 不 是 项 目的 质量 上 。 优 化 的 价 
值 显而易见 ， 缺 陷 被 更 快 地 发 现 和 修复 。 而 且 ， 需 求 和 实现 的 不 一 致 也 能 快速 被 发 现 。 新 
的 开发 者 能 快速 融入 该 项 目 ， 因 为 通过 观察 和 运行 测试 ， 他 们 能 相对 独立 地 理解 代码 。 一 
个 单元 测试 覆盖 率 高 的 项 目 能 在 大 规模 重 构 后 很 好 地 活 下 来 。 能 进行 如 此 重 构 的 信心 来 源 
于 这 些 自动 化 的 测试 ， 它 们 保证 了 功能 的 完 
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7.2.3 例子 : 绿地 开发 

作为 新 项 目的 架构 师 ， 你 需要 负责 挑选 最 适用 的 工具 ， 建 立 起 系统 的 初始 架构 。 对 于 云 
部 署 的 、 高 扩展 性 的 Web 应 用 ， 可 采用 本 书 描述 的 客户 端 一 服务 器 端 架 构 。 团 队 采 用 一 
些 新 的 工具 和 流程 是 允许 的 ， 而 采用 Java 作为 编程 语言 是 必需 的 ， 因 为 这 是 经 过 实践 的 ， 
在 内 部 被 证 明 是 能 够 胜任 工作 的 (这 就 除去 了 使 用 Rails 和 Grails 等 依赖 其 他 JVM 语言 
的 可 能 性 )。 


















































首先 我 们 想到 了 Maven/JEE。 虽 然 JAX-RS 也 适合 开发 服务 器 端 程序 ， 但 JSF 会 诱导 开发 
者 使 用 会 话 ， 这 不 是 我 们 想 看 到 的 。 





一 香 调 查 之 后 我 们 发 现 ， 可 使 用 Spring Roo 或 Play 这 样 的 服务 器 端 框架 ， 来 减轻 构建 和 部 
署 应 用 服务 器 的 负担 。 这 里 我 们 选用 了 Play， 生 成 服务 器 端 API， 使 用 一 些 存储 在 文件 系 
统 之 中 的 示例 JSON 文件 向 外 提供 数据 。 这 些 模拟 的 服务 会 被 稍 后 集成 后 端的 服务 替换 。 


前 端 项 目 使 用 Yeoman 创建 ， 并 可 能 会 用 到 JavaScript 框架 和 相关 的 HTML5 项 目 。 键 
入 npm search yeomangenerator 会 返回 一 些 备 选项 ， 使 用 它们 生成 一 个 或 多 个 客户 端 项 
目 一 一 各 自在 独立 的 目录 底下 。 通 过 几 个 小 时 的 调研 〈 将 前 端 项 目 集成 到 现 有 服务 上 )， 
就 能 大 概 了 解 每 个 项 目的 价值 ， 然 后 选择 一 个 最 适用 的 项 目 。 


最 后 做 一 些 清理 工作 收尾 ， 包 括 提供 服务 器 端 和 客户 端的 示范 单元 测试 ， 文 件 保存 后 就 能 
自动 运行 ， 使 用 工具 让 Java 和 JavaScript 的 文档 自动 化 ;将 代码 提交 到 SVN， 在 持续 集 
成 服务 器 上 注册 和 配置 项 目 ， 代 码 构 建 完 成 后 ， 服 务 器 生成 文档 并 发 送 到 统一 的 文档 服务 
器 ; 并 创建 一 份 IDE 模板 ， 包 含 经 过 一 致 同 意 的 代码 规范 默认 选项 。 












































这 些 决策 允许 客户 端 和 服务 器 端 进行 相对 独立 并行) 的 开发 。 通 过 单元 测试 和 具体 的 例 
子 ， 开 发 者 为 新 功能 添加 测试 时 可 以 直接 复制 ， 得 到 快速 反馈 ， 也 允许 发 布 自动 生成 的 文 
档 和 IDE 模板 ， 鼓 励 大 家 相对 一 致 地 编码 和 注释 。 




















这 些 例 子 都 很 主观 ， 随 着 新 技术 的 出 现 ， 毫 无 疑问 会 改变 和 提高 。 它 们 的 意义 在 于 证 明了 


























与 其 盲 日 地 遵循 前 人 的 实践 和 习惯 ， 对 流程 做 持续 改进 也 是 可 行 的 。 后 面 的 几 市 则 在 帮助 
大 家 进行 头脑 风暴 ， 发 现 那些 项 目 中 有 待 提 高 的 地 方 。 


7.3 生产 率 和 软件 开发 生命 周期 


需要 在 软件 开发 生命 周期 的 各 个 阶段 思考 如 何 提高 生产 效率 。 这 是 因为 对 于 流程 一 个 地 方 
的 改进 ， 不 一 定 会 带 来 其 他 地 方 生产 效率 的 提升 。 总 的 来 说 ， 可 以 将 和 提高 生产 效率 相关 
的 任务 按照 收益 递减 的 顺序 排出 优先 级 。 虽 然 项 目 和 团队 各 异 ， 还 是 可 以 总 结 出 一 些 会 产 
生 主 要 影响 的 因素 。 总 的 来 说 ， 管 理 方式 和 企业 文化 是 最 根本 的 ， 然 后 是 整体 的 技术 架 






































快速 开发 实践 | 101 





构 、 有 具体 的 应 用 设计 和 底层 编码 以 及 平台 选择 。 对 任务 有 了 准确 的 分 析 和 优先 级 ， 就 能 按 
照 影响 生产 效率 的 重要 程度 优化 处 理 。 








7.3.1 管理 方式 和 企业 文化 

通常 来 说 ， 从 总 体 上 把 握 由 很 多 人 参与 的 项 目 能 带 来 最 大 的 收益 。 虽 然 这 不 是 本 书 的 重 
点 ， 但 是 管理 方式 、 团 队 活力 和 工作 文化 对 所 要 完成 的 工作 影响 次 远 。 这 些 环境 因素 设 定 
了 工作 目标 、 组 织 和 个 人 的 价值 观 。 它 们 效果 显著 ， 常 常 是 最 应 该 重视 的 地 方 。 统 一 目标 
是 最 大 的 挑战 ， 尤 其 对 大 型 组 织 来 说 。 查 理 . 芒 格 (http:/www.ycombinator.com/munger. 
html)， 商 人 和 投资 家 ， 因 与 沃 伦巴 非特 的 关系 而 被 人 们 所 熟知 ， 他 描述 过 联邦 快递 将 员 
工 和 组 织 的 目标 统一 起 来 ， 从 而 消除 延迟 这 一 挑战 。 问 题 的 解决 之 道 在 于 保证 所 有 参与 者 
得 到 适当 的 激励 : 















































在 所 有 的 商业 案例 中 ， 我 最 喜欢 的 有 关 激励 措施 的 案例 是 联邦 快递 。 联 邦 快递 的 
系统 核心 一 一 创建 了 产品 的 信誉 一 一 是 让 所 有 的 飞机 在 午夜 到 达 同 一 个 地 方 ， 然 
后 将 包 衰 在 飞机 之 间 分 发 。 如 果 有 延误 ， 整 个 运营 团队 就 不 能 把 包 庄 按 照 所 承诺 
的 那样 按时 送 达 联邦 快递 的 客户 手中 。 








他 们 总 是 把 事情 摘 砸 ， 从 来 不 能 按时 完成 任务 。 他 们 试 遍 了 各 种 方法 一 道德 说 
教 、 威 胁 ， 总 之 各 种 你 能 想得到 的 方法 。 但 是 ， 都 不 起 作用 。 
最 后 ， 有 人 想 了 个 办 法 ， 降 低 他 们 的 计时 工资 ， 提 高 计件 工资 一 一 做 完 后 就 能 回 





家 。 一夜 之 间 ， 问 题解 决 了 。 


保持 合适 的 激励 是 非常 重要 的 一 课 。 这 种 解决 方案 对 那 时 的 联邦 快递 来 说 还 不 是 
很 明显 。 但 是 现在 ， 对 大 家 来 说 这 都 是 显而易见 的 了 。 





查理 。 芒 格 ( http:/www.ycombinator.com/munger.html ) 














还 有 其 他 一 些 “ 大 的 方面 ”需要 考虑 : 那些 基本 的 组 织 和 管理 原则 依然 适用 。 分 工 明确 、 
文档 集中 化 管理 、 使 用 版 本 控制 ， 这 些 看 起 来 都 很 新 鲜 ， 但 却 常 常 被 包 略 。 


7.3.2 ”技术 架构 

系统 的 整体 架构 决定 了 后 续 技 术 的 选 型 和 实现 。 一 个 在 大 范围 、 公 开 部 署 的 高 扩展 、 基 
于 云 的 应 用 和 组 织 内 部 使 用 的 应 用 不 同 ， 需 要 更 加 复杂 的 配置 ， 后 一 种 场景 对 错误 的 容 
忍 . 度 也 高 。 如 果 成 员 需 要 在 编码 时 考虑 那些 永远 也 不 会 发 生 的 场景 ， 或 者 在 项 目 后 期 要 
适应 没 预料 到 的 架构 要 求 ， 整 个 团队 的 生产 效率 就 会 受到 拖累 。 架 构 选 型 时 应 该 明确 项 
目的 范围 。 



































数据 存储 方式 的 选 型 是 另外 一 个 相似 的 例子 。 人 们 对 传统 的 关系 型 数据 库 理解 相对 充分 ， 
已 提供 了 引用 和 事务 完整 性 ， 开 发 者 认为 这 是 理所当然 的 。 新 出 现 的 NoSQL 方案 提供 了 
优化 的 写 操作 ， 以 一 种 限制 更 小 的 方式 存储 数据 。 每 种 方案 都 有 自己 的 优势 ， 但 是 没有 一 
种 锦 吉 妙 计 能 覆盖 所 有 的 情况 。 出 于 对 数据 扩展 性 的 考虑 ， 可 能 采用 NoSQL 方案 。 但 是 
如 果 一 开始 没有 考虑 到 报表 功能 ， 数 据 就 不 会 以 一 种 利于 高 效 生成 报表 的 方式 存储 。 开 发 
者 可 能 技术 出 众 、 效 率 极 高 ， 但 是 在 完成 具体 的 报表 任务 时 ， 也 无 法 逾越 因为 采用 了 错误 
的 数据 存储 方式 而 导致 的 润 沟 。 


每 一 门 语言 都 有 自己 忠诚 的 信徒 ， 他 们 乐此不疲 地 为 各 自 语 言 的 优点 辩论 。 可 以 确定 的 一 
点 是 ， 对 于 一 项 给 定 的 任务 ， 某 门 语言 的 特性 能 让 其 在 更 短 的 时 间 内 ， 更 简单 地 完成 任 
务 。 比 如 ， 如 果 不 需要 编译 (通过 使 用 IDE 的 自动 编译 选项 或 者 脚本 语言 )， 任 务 就 能 
更 短 的 时 间 完 成 。 像 Java 这 样 的 语言 ， 有 大 量 现成 的 函数 库 可 用 ， 而 其 他 一 些 新 语言 ， 比 
如 Scala 和 Groovy， 则 奔 炮 和 其 他 语言 有 根本 性 的 不 同 ， 使 用 较 少 的 代码 就 能 完成 同样 的 
任务 。 像 Ruby 和 Python 这 样 的 脚本 语言 则 有 它们 自己 的 工作 流 ， 在 它们 的 领域 里 效率 很 
高 ， 而 且 也 影响 到 了 其 他 语言 所 使 用 的 工具 和 流程 。 
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7.3.3 软件 工具 

选择 编程 语言 、 开 发 工具 和 框架 是 架构 师 确立 项 目 方向 的 主要 领域 。 每 个 程序 员 在 开发 项 
目 过 程 中 所 具备 的 能 力 、 所 受到 的 限制 都 深刻 地 受到 这 些 决定 的 影响 。 技 术 和 与 之 相关 的 
工作 流程 都 有 各 自 的 考虑 ， 生 产 效率 不 可 避免 地 会 受到 这 些 选 择 的 影响 。 

















在 Sofiware Tools (Addison-Wesley Professional 出 版 ，1976) 一 书 中 ，Brian Kernighan 说 过 
一 句 名 言 :“ 编 程 的 精髓 在 于 控制 复杂 度 。” 试 图 降低 复杂 度 的 软件 工具 遍及 软件 开发 生命 
周期 的 方方面面 : 版 本 控制 系统 、 文 档 自 动 化 、 履 盖 率 和 质量 报告 、 测 试 工具 、 事 项 管理 
系统 和 持续 集成 服务 器 ， 这 里 只 是 仅 举 几 例 。 除 过 这 些 ， 每 位 开发 者 所 掌握 的 日 常 工具 也 
能 让 他 和 同 修之 间 在 效率 上 差 好 几 个 数量 级 。 


















































每 门 编程 语言 都 有 与 之 相关 的 构建 工具 。 虽 然 可 以 混用 语言 和 构建 工具 ， 但 是 基于 Maven 
的 Java、Gradle 的 Groovy、SBT 的 Scala、Rake 的 Ruby 都 是 紧密 联系 在 一 起 的 。 每 门 语 
言 都 有 开发 客户 端 - 服 务 器 端 Web 应 用 的 相关 框架 。Java 有 JEE 和 Spring ( 借 由 一 款 高 
度 自动 化 的 工具 Roo)， 还 有 一 些 较 新 的 框架 ， 比 如 Play (同时 支持 Scala) 。 同 样 ，Ruby 
有 Rails、Groovy 有 Grails、Python 有 Django。 多 数 框架 包含 一 个 藤 入 式 服务 器 ， 以 方便 
开发 流程 。 他 们 通常 包含 起 始 项 目 ， 显 著 地 减少 了 费时 的 样板 代码 。 选 择 合适 的 框架 能 减 
少 构建 时 间 、 省 略 不 必要 的 完整 构建 、 享 受 预 处 理 资产 管道 所 带 来 的 好 处 、 方 便 地 和 测试 
进行 集成 。 

IDE 有 代码 补 全 、 智 能 搜索 、 代 码 导航 、 重 构 〈 将 一 段 代 码 抽取 成 一 个 新 方法 、 在 不 同 种 
类 的 文件 中 重 命名 变量 ) 、 单 元 测试 集成 、 后 台 编 译 等 功能 。 它 们 是 Java 社区 的 中 流 厂 柱 。 
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在 使 用 类 似 Java 这 样 的 语言 工作 时 ， 它 们 价值 连城 ， 以 致 有 些 开 发 者 觉得 程序 员 如 果 不 使 
用 IDE 完成 一 项 任务 简直 难以 置信 。 








使 用 脚本 语言 (尤其 那些 不 是 为 JVM 而 开发 的 脚本 语言 ) 的 开发 者 倾向 于 使 用 轻 量 级 的 
代码 编辑 器 ， 如 果 在 *nix 系统 的 命令 行 里 工作 '，vi (或 者 vim) 和 Emacs 和 它们 内 置 的 一 
些小 工具 会 为 软件 开发 提供 类 似 (或 者 更 好 ) 的 编辑 功能 。 即 使 你 不 总 是 在 命令 行 下 工 
作 ， 精 通 命 令 行 也 是 很 有 必要 的 ， 因 为 很 多 支持 的 任务 (部署 服务 器 、 查 看 日 志 、 检 查 服 
务 器 性 能 ) 都 得 在 命令 行 下 完成 。 






































7.3.4 性 能 

性 能 越 好 的 应 用 ， 调 试 起 来 越 快 。 让 和 迭代 周期 《反馈 循环 的 长 短 ) 最 得， 修改 和 验证 项 目 
的 机 会 就 更 多 。 优 化 性 能 差 的 代码 ， 能 为 开发 者 节省 出 时 间 干 其 他 的 事 ， 而 不 是 在 那儿 干 
等 着 系统 响应 。 一 开始 选择 的 API、 算 法 、 数 据 存储 机 制 和 相关 的 流程 会 自 上 而 下 影响 性 
能 。 甚 至 编程 语言 范 型 的 选择 都 会 影响 性 能 ， 比 如 函数 式 编程 〈 它 以 避免 产生 副作用 而 著 
称 )， 通 常 可 用 来 构建 高 效 的 缓存 机 制 。 它 还 可 以 使 用 非常 简洁 、 易 于 理解 的 代码 高 效 饥 
历数 据 结构 。 它 简化 了 流程 ， 使 用 更 少 的 代码 就 能 完成 重 构 。 应 用 的 性 能 和 代码 的 可 读 性 
都 会 因 正确 的 技术 (正确 的 团队 ) 选择 而 受益 。 即 使 在 一 个 成 熟 的 项 目 中 ， 也 有 可 优化 的 
地 方 。 比 如 很 多 Web 应 用 的 网 络 性 能 都 可 通过 压缩 或 减少 连接 次 数 而 受益 。 这 些 细节 通常 
在 项 目的 早期 被 忽视 ， 但 在 后 期 可 以 通过 非 破坏 性 的 方式 来 实现 。 对 性 能 的 提升 总 能 带 来 
其 他 好 处 ， 开 发 者 能 用 节省 下 来 的 时 间 来 编码 和 测试 ， 而 无 需 等 待 系统 响应 。 


通过 更 一 般 的 应 用 设计 ，RESTful 风格 的 应 用 也 会 提高 生产 效率 。 客 户 端 - 服务 器 端的 架 
构 允 许 并 行 开发 ， 调 试 和 维护 也 更 简单 ， 同 时 简化 了 很 多 在 其 他 时 候 会 很 复杂 的 任务 。 这 
些 益 处 对 开发 系统 中 独立 的 模块 也 适用 。 正 确 地 将 项 目 模块 化 ， 会 在 前 期 高 效 地 实现 项 
目 ， 而 那些 扩展 性 不 好 的 方案 可 在 后 期 重 写 。 良 好 的 设计 会 提高 日 后 的 生产 效率 。 
















































































7.3.5 测试 

早先 的 测试 很 随意 ， 边 用 边 测 ， 现 在 测试 已 经 成 为 一 种 正规 化 的 操作 了 。 自 动 化 测试 ( 包 
括 将 测试 集成 进 构建 过 程 ) 是 有 信心 大 规模 重 构 系 统 所 必需 的 ， 也 是 自动 化 部 署 的 基础 。 
自动 化 测试 早先 只 是 断断续续 地 在 运行 ， 频 率 也 不 高 。 现 在 处 理 器 能 力 增强 了 ， 每 次 项 目 
构建 (或 文件 保存 ) 时 运行 测试 也 是 可 行 的 。 测 试 的 范围 会 因 项 目的 成 熟 度 而 变化 ， 但 在 
大 多 数 非 平 几 的 Web 开发 中 都 是 必需 的 。 测 试 已 经 在 JavaScript 社区 树立 了 牢固 的 地 位 ， 
它 让 人 们 可 以 开发 出 大 型 的 项 目 ， 能 在 各 种 浏览 器 和 设备 上 可 靠 地 执行 。 为 了 应 对 基于 



























































注 1: 对 门外汉 来 说 ， 星 号 在 程序 员 的 语言 里 是 通配符 的 意思 。*nix 代表 “Unix 和 类 Unix 系统 ， 比 如 
Linux”。*nix 还 包含 苹果 公司 的 OS X， 但 是 不 包括 Windows。 可 在 Windows 上 运行 类 似 Cygwin 这 
样 的 工具 ， 让 其 看 起 来 像 个 Unix 系统 。 
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云 的 部 署 ， 人 们 开发 出 新 形式 的 测试 ， 比 如 Netflix 公司 的 Chaos Monkey (http://techblog. 


netflix.com/2012/07/chaos-monkey-released-into-wild.html) ， 它 通过 主动 触发 失败 ， 帮 助 姑 


F 发 





出 可 恢复 的 服务 。 


合理 地 执行 测试 ， 能 方便 程序 员 和 计算 机 之 间 的 交流 ， 也 能 方便 程序 在 团队 之 间 进 行 交 
流 。 竺 一 看 还 不 明显 ， 毕 竞 测试 的 目的 是 为 了 理解 和 验证 软件 的 可 靠 性 和 功能 的 。 一 些 
类 型 的 测试 会 显著 提升 大 型 项 目的 生产 效率 。 当 测试 减轻 了 集成 的 痛 苗 、 提 升 了 产品 质 
量 时 ， 效 果 就 变 得 显而易见 了 。 遵 循 行为 驱动 开发 范 型 的 测试 ， 能 在 代表 各 领域 的 项 目 
成 员 之 间 搭 建 一 条 一 致 的 沟通 渠道 ， 通 过 一 种 更 精妙 的 方式 来 提高 生产 效率 。 正 如 The 
Cucumber Book: Behaviour-Driven Development for Testers and Developers (https://pragprog. 


























com/book/hwcuc/the-cucumber-book) 一 书 所 说 : 
“ 当 开 发 者 和 业务 干系 人 能 明白 无 误 地 沟通 时 ,软件 团 队 才能 以 最 好 的 方式 工作 。 
一 种 非常 好 的 方式 是 合作 编写 自动 化 的 验收 测试 来 描述 任务 …… 当 团队 能 合作 编 
写 验收 测试 时 ， 他 们 能 发 展 出 自己 的 特殊 语言 来 描述 领域 内 的 问题 ， 这 可 以 帮助 
他 们 避免 误解 。” 


更 好 的 沟通 减少 了 误解 浪费 的 时 间 ， 更 好 的 理解 会 产生 更 好 的 产品 。 


当 测 试 影响 生产 效率 时 该 怎么 办 ? 

有 了 时候 运行 测试 会 成 为 负担 ， 降 低 生产 效率 。 编 写 和 维护 测试 需要 时 间 ， 运 
行 测 试 需要 时 间 和 资源 。 和 其 他 开发 任务 一 样 ， 测 试 的 精力 和 时 间 本 可 以 用 
其 他 地 方 。 这 导致 了 开发 者 和 其 他 人 在 很 大 程度 上 减少 了 测试 。 





























现在 将 测试 集成 进 Web 应 用 已 经 变 得 相对 容易 ， 很 多 启动 项 目 都 包含 了 测试 
相关 的 配置 。 为 了 最 大 限度 发 挥 测试 的 价值 ， 需 要 鼓励 形成 尊重 测试 价值 、 
将 维护 测试 当成 真正 的 工作 ， 并 且 认 为 这 是 物 有 所 值 的 文化 。 不 能 说 测试 会 
直接 提高 生产 效率 ， 但 对 大 多 数 拥有 较 长 生命 周期 的 项 目 来 说 ,测试 的 价值 
是 不 能 被 低估 的 。 




















7.3.6 ”底层 平台 





操作 系统 和 安装 的 基础 软件 组 成 了 底层 部 署 平台 。 具 有 一 两 台 强 大 处 理 器 的 工作 站 (加 
上 一 台 额 外 的 显示 器 以 增 大 屏幕 的 实际 使 用 面积 ) 就 抵 得 上 几 年 前 的 一 台 超 级 计算 机 。 
为 JVM 分 配 足够 的 内 存 、 关 闭 不 需要 的 程序 节省 资源 ， 这 些 可 能 会 有 一 定 的 价值 ， 但 是 
应 用 的 设计 常常 才 是 更 重要 的 因素 。 在 有 些 情况 下 ， 一 个 更 快 的 文件 系统 会 显著 影响 构 











建 时 间 。 


是 使 用 集中 化 的 数据 库 ， 还 是 使 用 开发 者 各 自 维护 的 备份 也 是 一 个 重要 的 决定 。 在 开发 者 
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维护 的 场景 里 ， 迁 移 时 可 使 用 FlyWayDB (http://flywaydb.org/) 这 样 的 框架 。 如 果 需 要 远 
程 使 用 资源 ， 网 络 就 成 了 问题 ， 和 分 散在 各 地 的 团队 一 起 工作 时 尤其 如 此 。 


























7.4 小结 


本 章 有 意 不 提供 示例 项 目 。 生 产 效 率 ， 或 开发 时 的 效率 需要 后 退 一 步 考 虑 现 有 的 选项 是 否 
和 和 手头 的 项 目 匹 配 。 项 目的 各 个 阶段 都 有 宏观 或 微观 的 任务 可 被 简化 、 自 动 化 ， 或 者 更 高 
效 地 完成 。 你 最 好 能 够 “上 来 透 口 气 ”， 它 能 让 你 充分 思考 现 有 的 选项 ， 做 出 最 佳 的 决策 。 
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API 设 计 





“ 纸 上 得 来 终 觉 浅 ， 绝 知 此 事 要 躬 行 。” 
一 一 陆游 ! 
解决 问题 有 两 种 基本 方式 : 由 全 面 的 理论 开始 逐渐 深入 细节 ， 或 者 从 一 个 细节 开始 逐步 发 
展 出 一 套 与 之 对 应 的 理论 。 喜欢 着 手 细节 的 人 ”通过 研究 每 一 个 具体 问题 来 解决 问题 。 
“喜欢 着 手 理论 的 人 ”适合 将 问题 分 类 到 他 们 自己 涉及 的 理论 范畴 内 。 每 种 解决 方式 都 有 
其 价值 ， 很 多 问题 的 解决 需要 熟练 地 在 两 种 方式 里 切换 。 
































哲学 范畴 
柏拉图 在 哲学 中 描述 的 “共性 ”是 抽象 的 最 高 和 最 根本 的 “思想 的 境界 ”。 而 他 的 学 
生 亚 里 士 多 德 发 现 了 他 们 的 特异 性 ， 特 别 是 现实 世界 的 事物 。 这 些 的 起 点 来 源 于 不 满 
足 的 求知 欲 。 在 设计 分 析 的 时 候 ， 起 点 会 影响 过 程 的 最 终结 果 。 最 好 的 解决 方案 往往 
是 这 两 种 方式 的 互补 。 这 些 古 老 的 起 点 与 Elsevier 的 著作 The Handbook of Statistical 
Analysis and Data Mining Applications (统计 分 析 与 数据 挖掘 应 用 手册 》) 中 提出 的 现 
代数 据 科 学 技术 有 关 : 


传统 的 统计 分 析 在 做 数据 集 相关 性 检索 时 会 遵循 关系 演绎 法 ， 人 工 智 能 ( 例 
如 ， 专 家 系统 ) 和 机 器 学 习 (例如 ， 神 经 网 络 和 决策 树 ) 则 会 按照 归纳 法 来 
执行 。 排 除法 (或 演绎 推理 ) 是 亚 里 土 多 德 分 析 详细 数据 的 过 程 ， 计 算 一 系 
列 数据 ， 然 后 形成 出 一 些 基 于 (或 推断 ) 这 些 数据 的 数学 。 归 纳 是 使 用 数据 
集中 的 信息 作为 “跳板 ”来 得 出 没有 完全 包含 在 输入 数据 中 的 通用 结论 。 

















注 1: 原文 为 “In theory, there is no difference between theory and practice. But, in practice, there is. —Author Unknown” 。 
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REST 及 Web API 设计 实践 也 是 这 些 起 点 的 代表 。 罗 伊 ' 工 . 非 尔 丁 以 纯粹 的 抽象 术语 清晰 
地 表达 了 REST。RESTful Web API 受 到 了 REST 原则 的 启发 ， 可 以 解决 具体 问题 ， 也 可 
以 接受 不 完全 符合 该 理论 的 实现 细节 。 大 部 分 对 REST 讨论 的 分 歧 都 可 以 追溯 到 各 方 有 意 
或 无 意 选 择 的 起 点 。 


REST 规范 显然 为 Web API 的 设计 者 提供 了 一 些 立 即 可 以 使 用 的 价值 。 对 客户 端 和 服务 端 
进行 分 区 后 ，HTTP 动词 以 及 标识 Web 资源 ， 已 经 被 明确 证 明 有 助 于 创造 各 种 现实 世界 
的 Web 接口。 事实 上 HATEOAS ( 超 媒 体 即 应 用 状态 引擎 ) ， 虽 然 在 理论 上 引 人 人 注目， 但 
是 实际 上 已 经 难以 持续 。 尤 其 是 在 现在 的 Web API 实际 上 都 使 用 了 JSON 作为 数据 传输 格 
式 ,， 使 用 HATEOAS 就 更 加 困难 了 。 


8.1 设计 的 起 点 


虽然 Web 服务 已 经 以 某 种 形式 存在 许多 年 ， 但 是 并 没有 立即 转 而 使 用 它们 作为 基础 的 设计 
元 素 。 逐 步 采 用 的 Ajax，JSON 的 出 现 以 及 相关 轻 量 的 Web API[， 首 先 影响 的 是 已 经 存在 
于 服务 端的 MVC 系统 。 通 过 开发 者 的 推动 ， 这 些 技术 的 极限 已 经 可 以 用 来 创建 复杂 的 单 
页 面 应 用 程序 ， 很 明显 ， 服 务 端 驱动 的 MVC 方法 并 没有 与 这 些 广泛 使 用 的 新 技术 进行 很 
好 的 适 配 。 这 使 得 Web 应 用 的 设计 发 生 了 根本 的 改变 ， 打 破 了 原 有 实践 的 延续 性 。 图 8-1 
所 示 的 时 间 线 展示 了 引领 CS 风格 Web 应 用 的 技术 发 展 历程 。 

























































































切换 到 客户 端 - 服务 端 开 发 方法 
客户 端 一 服务 端 Web 开发 用 到 的 技术 并 不 新 鲜 ， 编 程 语言 变 得 越 来 越 成 元 ， 但 是 没 
有 本 质 上 的 区 别 ， 服 务 器 和 浏览 器 ， 以 及 HTTP 协议 从 Web 创建 开始 就 已 经 存在 。 然 
而 ， 直 到 最 近 才 开始 采用 一 致 的 设计 方法 ， 而 这 大 部 分 来 源 于 正在 开发 的 各 种 技术 。 


起 初 服务 端 输出 和 客户 端 泻 染 的 那些 页 面部 很 简单 。20 世纪 90 年 代 中 期 ， 通 过 服 
务 器 闯 CGI 和 浏览 器 痛 JavaScript 程 序 才 引 入 了 动态 内 容 。 因 为 客户 应 不够 强力， 
JavaScript 也 比较 慢 ， 所 以 更 多 地 是 通过 服务 端 来 处 理 和 创建 动态 内 容 ， 为 了 解决 这 种 
复杂 性 在 服务 痛 引 入 了 类 似 模型 -视图 - 控制 器 (MVC) 这 样 的 设计 模式 。 


MVC 模式 依旧 是 服务 器 端 Java 开发 的 主要 模式 ， 并 且 出 现在 各 大 标准 (例如 JEE) 
以 及 框架 中 (例如 Spring)。 后 来 类 似 Ajax 和 JSON 这 样 的 JavaScript 创新 技术 立即 影 
响 了 服务 器 痛 的 MVC 开发 者 ， 他 们 开始 零 零 碎 碎 地 使 用 了 这 些 技术 。 框 架 并 没有 消 
失 ， 只 是 他 们 的 设计 和 使 用 受到 了 显著 影响 。 在 设计 方面 ， 例 如 Spring 这 类 MVC 杠 
架 都 采用 了 “优雅 的 网 址 ”来 反映 资源 的 行为 。 在 使 用 方面 ，API 当然 可 以 很 好 地 与 
传统 的 MVC 框架 结合 。 不 论 用 什么 框架 ， 今 天 的 许多 应 用 是 基于 Web API 而 非 MVC 
的 ， 实 际 上 这 是 一 种 客户 端 一 服务 端 模式 。 
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图 8-1: 客户 端 - 服务 端 Web 


开发 技术 历史 更 和 迭 


客户 端 - 服务 端 模式 涉及 的 一 种 具体 设计 方法 是 : 通过 开发 RESTful 风格 的 Web API 来 将 
数据 传输 到 客户 端 视图 并 且 避 免 在 服务 端 做 视图 的 泻 染 。 这 样 带 来 的 一 个 问题 是 ， 如 何以 





























一 致 、 可 支持 的 方式 来 设计 





| 最 好 的 Web API。 这 种 类 型 的 设计 决策 常常 引发 许多 观点 ， 但 


总 是 会 在 一 个 点 上 达成 明确 的 共识 。 一 般 的 共识 是 ， 受 REST 影响 的 Web API 不 应 该 受到 
有 争议 或 者 不 切实 际 的 约束 的 严格 限制 。 








8.2 ”实用 的 W 


eb API 与 REST API 


虽然 实用 性 和 个 人 的 理解 有 关 ， 但 普遍 的 共识 是 认为 Web API 应 该 易于 使 用 。 他 们 应 该 易 
于 外 部 开发 者 理解 、 具 有 一 致 性 、 可 预测 ， 并 且 大 部 分 符合 REST。REST 的 某 些 实现 提 
供 了 易 用 性 设计 ， 虽 然 REST 早期 的 规范 并 没有 特别 关注 短期 的 生产 力 和 对 开发 者 的 易 用 
性 ， 因 为 REST 常常 容易 理解 。 














菲 尔 丁 如 是 说 …… 


“REST 是 要 做 数 十 年 的 软件 设计 : 每 个 细节 都 是 为 了 迁 长 软件 的 生命 周期 并 且 能 够 独 
立 选 代 。 许 多 限制 都 是 为 了 对 抗 短期 效率 。 





一 一 罗 伊 .T. 菲 尔 丁 














那么 问题 是 ，REST 在 实践 中 最 容易 应 用 的 是 哪 一 部 分 呢 ? 以 资源 的 一 致 性 标识 作为 名 词 
以 及 它 所 遵循 的 HTTP 动词 是 REST 的 基础 核心 ， 特 别 在 那些 依赖 于 CRUD 操作 的 应 用 中 





尤为 明显 。 优雅 的 URL” 





就 是 这 种 标识 的 一 种 产物 。REST 不 涉及 有 具体 的 性 能 要 求 ， 但 











其 引用 的 可 缓存 资源 能 够 有 助 于 系统 提高 其 执行 及 扩展 能 力 。 当 然 ， 正 如 前 面 章节 所 描 
述 ， 对 客户 端 - 服 务 端 之 间 差 异 的 了 解 有 极 大 的 价值 。REST 一 直 能 有 着 如 此 的 影响 力 ， 
因为 它 的 设计 理念 倾向 于 促进 Web 设计 本 身 的 一 致 性 。 工 程 化 良好 的 应 用 程序 ， 在 部 分 使 




















用 了 REST 的 时 候 ， 会 变 得 更 易 理解 和 扩展 。 
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有 些 Web API 的 实现 与 REST 的 理念 存在 冲突 。 其 中 最 值得 注意 的 是 ， 使 用 JSON 将 导致 
通过 媒体 类 型 定义 的 连接 性 的 缺失 。 对 缺少 连接 性 的 媒体 类 型 的 使 用 会 直接 导致 API 无 
法 自我 描述 ， 因 此 ， 需 要 求助 于 文档 。 识 别 REST 中 没有 直接 提 到 的 一 系列 动作 会 更 具 挑 
战 。 在 REST 领域 之 外 ， 还 需要 探讨 API 安全 性 及 可 维护 性 等 相关 话题 。 




















尽管 菲 尔 本 的 Web API 设计 并 不 全 面 ， 但 确实 能 应 用 于 其 他 领域 。 尽 管 接口 返回 内 容 是 否 
易于 阅读 并 不 是 REST 实践 特别 关注 的 ， 但 菲 尔 丁 还 是 特别 指出 了 使 用 诸如 Java applet 等 
方案 时 导致 的 可 见 性 缺失 的 问题 。 这 种 关注 可 能 意味 着 在 许多 情况 下 ， 格 式 化 后 的 JSON 
或 许 是 有 好 处 的 。 给 客户 端 开发 者 提供 的 信息 的 清晰 度 比 压缩 信息 节省 的 那 点 空间 更 重要 
(服务 端 压缩 可 以 更 有 效 地 改善 传输 大 小 和 性 能 ) 


REST 被 设想 为 一 个 抽象 模型 。 抽 象 模型 经 得 起 时 间 和 空间 之 外 的 考验 。 因 此 它 不 会 直 
接 考虑 系统 会 随时 间 改 变 。 出 于 易 用 性 的 考虑 ， 建 议 所 有 的 改变 请 尽 可 能 保持 向 后 兼容 。 
API 的 版 本 化 正好 为 这 个 方向 提供 了 巨大 的 灵活 性 。 


回头 来 看 ， 统 一 的 接口 其 实 是 REST 的 一 种 约束 。 统 一 的 接口 几乎 完全 是 自 描述 的 。 理 想 
情况 下 ， 拥 有 这 些 API 的 系统 可 以 不 需要 文档 作为 系统 切入 点 。 这 与 SOAP 之 类 的 协议 有 
着 鲜明 的 对 比 ， 它 们 常常 需要 引入 Web 服务 描述 语言 (WSDL) 来 描述 Web 服务 的 功能 。 
一 个 RESTful 风格 的 系统 将 提供 所 有 资源 的 链接 ， 并 且 不 需要 任何 额外 的 说 明 。 在 实际 的 
应 用 中 ，Web API 如 果 配 合 上 和 良好 的 文档 则 会 更 加 可 用 。 


8.3 指引 


与 那些 规范 需要 由 标准 委员 会 来 制订 的 技术 不 同 ，Web API 可 以 由 开发 者 随意 构造 ， 实 际 
上 ， 创 建 符合 更 大 范围 的 开发 者 社区 期 望 的 API 是 件 很 有 意义 的 事情 。 接 下 来 的 小 节 反 映 
了 REST 在 开发 轻 量 级 Web 服务 时 所 带 来 的 显著 影响 。 它 们 都 被 推荐 为 设计 简单 易 懂 且 可 
用 的 Web API 的 指引 。 




































































8.3.1 名词 即 资源 ， 动 词 即 HTTP 行 为 

在 REST 中 指定 了 资源 作为 名 词 。 名 词 在 RESTful 系统 中 表示 了 URL 路 径 以 及 用 于 操作 
资源 的 引用 。 行 为 即 那些 与 功能 相对 应 并 用 于 操作 资源 的 动词 。 在 RESTful 系统 中 动词 特 
指 HTTP 操作 。 











资源 与 对 象 、 实 体 以 及 其 他 设计 方法 中 的 表 相 对 应 。 名 词 可 用 UML 类 图 中 的 类 建 模 。 它 
们 被 建 模 为 实体 ， 之 后 在 ER 图 (Entity Relationship Diagram，ERD) 中 被 实现 为 关系 型 数 
据 库 中 的 表 。 








UML 类 图 和 ER 图 ， 它 们 是 基于 数学 的 图 形 符号 ， 但 点 和 边 在 这 些 图 上 还 
具有 额外 的 意义 。 

















特别 关注 名 词 的 并 非 只 有 UML 和 ER 图 ，REST 也 同样 如 此 。 表 8-1 示意 了 这 些 系统 之 间 
的 对 应 关系 。 在 REST 中 ， 名 词 被 用 来 表示 资源 ， 在 UML 类 图 中 它们 是 类 ， 在 ER 图 中 ， 
它们 是 数据 库 表 的 实体 。 在 为 REST API 分 析 和 系统 建 模 时 可 以 采用 对 UML 类 或 ER 图 进 
行 分 解 的 方法 。 在 映射 到 CRUD 操作 的 系统 中 更 是 如 此 。 


表 8-1: 模型 系统 的 名 词 含义 



































架构 名 词 表 示 的 实体 
面向 对 象 的 类 层次 结构 ”类 
关系 数据 库 表 
REST 接口 资源 





在 设计 包含 CRUD 操作 的 系统 时 ， 需 要 考虑 所 有 行为 对 每 个 资源 的 适用 性 。 这 样 可 以 避免 
以 后 因为 功能 需求 被 忽略 而 造成 的 系统 修改 。 例 如 ， 博 客 引擎 的 建 模 可 能 包含 用 户 、 博 客 
文章 以 及 评论 等 资源 。 大 部 分 博客 系统 需要 创建 、 读 取 和 删除 这 些 资 源 的 功能 ， 而 更 新 用 
户 或 者 修改 评论 可 能 就 不 是 必要 的 。 就 像 是 表 8-2 所 示 ， 第 一 列 定义 的 是 资源 (名词)， 每 
一 行 都 定义 了 行为 (动词 )。 














表 8-2: 简单 的 博客 接口 设计 网 格 
创建 ” 读 取 更 新 删除 








用 户 X X x 

文章 x x x x 

评论 天 元 x 
没有 相应 名 词 …… 





REST 模型 中 资源 是 架构 的 基础 单位 。 对 REST 资源 进行 分 析 所 采用 的 技术 
与 用 于 UML 类 图 及 ER 图 中 的 类 似 ， 能 够 很 好 地 映射 到 CRUD 类 型 的 应 用 。 
那些 不 是 基于 资源 的 应 用 可 以 被 视 为 一 组 动词 ， 这 样 的 应 用 用 一 系列 远程 调 
用 来 表示 更 好 ， 这 种 类 型 的 系统 无 法 简单 地 通过 RESTful 来 表示 。 

















许多 情况 下 ， 类 似 这 样 的 系统 可 以 被 重 构 为 以 资源 为 基础 ， 但 这 也 并 非 总 是 
可 行 。 对 某 些 系统 的 建 模 可 能 只 要 使 用 抽象 ， 但 对 有 些 系统 却 不 够 。 





8.3.2 ”请 求 参数 作为 修饰 符 
尽管 名 词 是 URL 中 重要 的 部 分 ， 动 词 会 关联 到 HTTP 的 行为 ， 但 这 仍然 不 足以 将 整 件 寻 





jl 
ee 
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情 描 述 清楚 。URL 的 其 他 部 分 会 包含 额外 的 信息 。 正 如 口语 的 语法 一 样 ， 话 语 中 的 额外 部 
分 将 用 于 确认 及 河清 名 词 和 动词 的 意图 。 




















当 引 用 的 内 容 是 一 系列 资源 的 时 候 ， 查 询 参数 就 变 得 十 分 有 用 。 这 些 参数 可 以 对 整个 集合 
进行 过 着 并 返回 其 中 的 子 集 ， 它 们 可 能 返回 选中 的 一 些 资源 ， 例 如 仅 返回 前 10 条 。 它 们 
也 可 以 对 结果 进行 排序 。 


























分 页 操作 是 过 滤 操 作 的 一 种 特例 。 可 以 用 参数 来 显 式 地 引用 返回 结果 的 子 集 。 请 求 参数 更 
加 适合 对 集合 请 求 返 回 的 数据 集 进 行 限制 (你 也 可 以 把 它 当 作 形 容 词 或 者 副词 看 待 )。 分 
页 的 意义 超越 了 请 求 参 数 的 用 法 ， 对 它 来 说 更 重要 的 是 链接 。 





GitHub 的 API 提供 了 一 个 文档 良好 的 分 页 参数 范例 。page 参数 表明 了 哪个 有 效 的 页 面 被 
返回 ，per_page 参数 则 会 将 返回 结果 限制 到 100 条 : 























curl https://api.github.com/user/repos?page=2&per_page=100 





HTTP GET 请 求 及 请 求 主体 
URL 中 的 请 求 参数 会 “丑化 ” 它 ， 不 然 会 “优雅 ”许多 。 在 菜 些 情况 下 ， 对 HTTP 
GET 而 言 ， 请 求 参数 看 上 去 是 一 个 必要 的 举措 ， 可 是 如 果 能 够 引入 一 个 请 求 对 象 ， 那 
么 将 可 以 更 容易 地 去 定义 一 个 分 层 的 数据 结构 。 比 如 去 获取 一 些 数据 ， 它 们 每 一 个 部 
是 由 不 同 的 字段 查询 拼接 而 成 。 罗 伊 *T, 菲 尔 丁 及 HTTP 规范 看 起 来 支持 这 样 做 ， 尽 
管 许多 情况 下 也 可 以 这 么 用 ， 但 是 由 于 缺少 对 服务 器 解析 主体 的 官方 要 求 ， 所 以 不 建 
议 在 系统 中 长 期 使 用 。 











8.3.3 Web API 版 本 


REST 并 没有 要 求 Web API 在 设计 的 时 候 考 虑 变更 及 修改 ， 它 的 约束 是 为 了 推广 更 加 轻松 
可 变 的 系统 。 接 口 版 本 化 是 菲 尔 丁 论文 中 未 提 及 的 重要 考虑 因素 。 在 URL 地 址 中 加 上 一 
个 版 本 号 可 以 防止 API 通过 干扰 客户 端的 行为 对 API 进行 修改 。 如 果 没 有 版 本 控制 ， 那 么 
在 服务 端 改变 的 时 候 就 需要 对 客户 端 做 同步 更 新 〈 这 在 许多 情况 下 是 不 可 能 的 ， 更 别 说 在 
实际 应 用 中 了 )。 虽 然 版 本 标识 符 理论 上 不 够 优雅 和 简洁 ， 但 是 却 极 大 地 提高 了 系统 的 可 
维护 性 。 这 是 因为 对 它们 的 用 法 存在 很 多 的 意见 ， 并 且 它 们 也 不 具备 自 描述 的 能 力 。 版 本 
号 在 使 用 的 时 候 的 数值 范围 不 是 自 描述 的 ， 所 以 在 Web API URL 路 径 中 的 版 本 片段 需要 
更 容易 被 辨识 出 来 并 且 应 该 有 更 有 效 的 文档 。 
























































对 于 将 版 本 号 放 在 哪个 地 方 存在 大 量 不 同 的 意见 。 有 些 人 建议 它 应 该 被 包含 在 URL 路 径 
之 中 ， 另 外 一 些 人 则 建议 将 它 作为 请 求 的 参数 ， 还 有 一 些 人 则 认为 版 本 信息 不 应 使 URL 
变 得 混乱 ， 他 们 建议 可 以 将 版 本 信息 通过 HITP 标 头 来 传递 。 











8.3.4 HTTP 标 头 

版 本 标识 符 是 唯一 一 个 多 用 途 (https://en.wikipedia.org/wiki/List_of_HTTP_header fields) 
的 请 求 和 响应 头 ， 其 他 一 些 非 相 关 信 息 也 可 以 存储 于 其 中 。Twitter 在 rate limit data 
(https://dev.twitter.com/rest/public/rate-limiting) 的 报告 中 提出 ， 当 开发 者 的 应 用 程序 即将 接 
近 某 个 临界 限制 时 ， 可 以 在 头 信息 中 对 他 们 发 出 警报 。ETag (http://www.w3.org/Protocols/ 
rfc2616/rfc2616-sec14.html) 可 以 用 于 控制 缓存 ， 其 他 的 头 信息 可 能 适用 于 安全 认证 和 授 
权 。 头 信息 常用 于 传递 次 要 但 必要 的 信息 ， 虽 然 它 们 并 不 符合 某 种 抽象 模型 ， 但 它们 却 有 
许多 实际 用 途 需 要 我 们 去 考虑 。 


Accept 和 Content type 这 两 个 头 信息 可 以 用 于 影响 服务 端 决 定 如 何 对 一 个 请 求 进行 响应 以 
及 提供 怎样 的 响应 ， 除 了 能 够 清楚 地 区 分 出 XML 和 JSON， 还 可 以 用 于 决定 JSONP 还 是 
JSON。JSON 内 容 可 以 “违反 ” 跨 域 限制 发 送 到 远 端 服务 器 的 某 种 能 力 ， 从 实质 上 来 看 ， 
它 允 许 访问 JSON 的 API， 其 返回 的 内 容 是 一 个 包含 了 JSON 内 容 的 函数 调用 。 本 章 后 面 
的 项 目 中 将 会 提供 这 样 的 示例 。 





























8.3.5 ”链接 

分 页 器 假定 了 这 种 能 力 ， 它 可 以 链接 到 与 当前 显示 子 集 相 关 的 上 一 个 及 下 一 个 资源 。 有 些 
API 的 设计 者 会 推荐 在 接口 的 返回 结果 中 包含 上 一 页 及 下 一 页 的 全 部 链接 ， 其 他 人 则 建议 
只 应 包含 相关 的 ID， 从 而 可 以 节省 空间 及 去 除 重复 的 内 容 。 虽 然 ， 在 返回 内 容 中 提供 链接 
往往 是 一 个 不 错 的 决定 ， 并 且 可 以 限制 对 额外 文档 的 需求 ， 严 格 意义 上 的 HATEOAS 并 不 
实用 ， 或 者 说 在 这 点 上 并 不 能 适用 于 所 有 的 场景 。 
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8.3.6 ”响应 

拥有 一 个 自 描述 的 API 是 个 非常 棒 的 想法 。 如 果 在 URL 中 指定 并 反映 了 资源 ， 并 且 利 用 
了 HTTP 动词 ， 就 可 以 实现 非常 好 的 自 描述 API。 遵 循 HTTP 响应 状态 码 的 使 用 约定 ( 例 
如 ，400 表示 客户 端 内 容 ， 而 500 表示 服务 器 问题 ) 也 可 以 帮助 实现 自 描述 API。 理 想 的 
情况 是 ， 系 统 的 错误 信息 可 以 为 问题 的 触发 原因 提供 快速 可 操作 的 描述 。 但 是 在 大 部 分 系 
统 里 ， 至 少 需 要 好 几 个 基础 领域 的 文档 。 错 误 码 和 信息 通常 有 点 简洁 ， 因 此 应 该 将 它们 作 
为 文档 的 索引 。 理 想 的 情况 是 ， 在 文档 里 可 以 按照 系统 错误 信息 对 错误 进行 描述 (例如 ， 
标识 出 PUT/POST/PATCH 的 所 有 字段 以 及 可 能 引发 的 错误 )。 

































































8.3.7 文档 

文档 应 该 能 够 轻松 地 定位 、 搜 索 和 理解 。 一 些 Web API 开发 者 采用 的 约定 是 使 用 Web 应 
用 描述 语言 (Web Application Description Language，WADL)， 这 是 一 种 机 器 可 读 的 Web 
应 用 描述 ， 一 般 为 XML 格式 。 在 这 种 方式 下 API 的 检索 很 简单 ， 但 是 如 果 仅 仅 通过 工具 
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来 构建 并 不 足够 。 开 发 者 可 以 通过 命令 行 的 Curl 操作 来 复制 提供 的 示例 ， 示 例 表明 想 要 构 
建 一 个 清晰 的 API 文档 还 有 很 多 工作 需要 做 。 如 果 API 是 面向 第 三 方 开发 者 的 ， 那 么 还 有 
更 多 的 细节 需要 注意 。 











RESTful Web API 的 文档 书写 需要 很 多 手动 工作 ， 不 过 ， 可 以 通过 工具 自动 生成 文档 来 减 
少 这 类 工作 的 负担 。 一 些 服务 能 够 基于 Web API 创建 可 用 的 WADL 资源 。 例 如 ， 在 运行 
阶段 ，Jersey 会 创建 一 个 基础 的 WADL， 你 可 以 通过 一 个 GET 请 求 访 癌 /application.wadl。 
通过 制定 选择 指令 可 以 增加 额外 的 信息 到 WADL 中 。 如 果 你 使 用 的 是 一 个 无 法 自动 生成 
WADL 的 服务 ， 可 以 添加 类 似 Enunciate (http://enunciate.codehaus.org/) 的 插件 使 得 你 的 
项 目 可 以 自动 生成 。 还 有 类 似 http://apiary.io 的 网 站 ， 在 这 类 站 点 上 你 可 以 脱离 特定 项 目 
的 上 下 文 来 设计 和 描述 API。 














8.3.8 格式 约定 

最 后 ， 遵 循 简单 的 格式 约定 可 以 使 得 一 个 API 更 加 清晰 明了 。 在 开发 初期 和 后 续 维护 中 ， 
开发 者 都 需要 经 常 地 查看 这 些 文档 。 由 于 JSON 属于 JavaScript， 遵 循 惯用 的 JavaScript 实 
践 比如 驼峰 命名 法 是 非常 有 意义 的 。 


另 一 种 简单 的 做 法 是 格式 化 的 JSON 响应 ， 这 使 得 人 们 更 易于 阅读 。 针 对 这 一 点 通常 的 争 
论 在 于 格式 化 的 JSON 增加 了 响应 内 容 的 大 小 ， 并 且 影 响 性 能 ， 不 过 通过 配置 开启 JSON 
响应 的 GZip 压缩 可 以 大 幅 提 升 性 能 。 在 格式 化 的 响应 中 增加 的 空间 相对 于 造成 的 性 能 损 
失 来 说 是 值得 的 ， 因 为 开发 者 可 以 直接 查看 返回 的 响应 ， 而 不 需要 先 在 IDE 中 进行 格式 化 
或 者 使 用 类 似 jq (http://stedolan.github.io/jq/) 的 命令 行 工具 。 


8.3.9 安全 性 

REST 没有 提供 明确 的 、 关 于 安全 性 的 建议 。 因 为 它 本 来 就 是 基于 可 以 将 API 公布 到 
Internet 上 的 要 求 来 设计 的 。 不 过 ， 通 过 HTTPS 而 不 是 HTTP 来 提供 API 也 是 一 个 好 主 
意 。 对 于 不 打算 限制 到 一 个 服务 器 上 的 API， 一 个 JSON 的 API 可 以 通过 JSONP 或 者 
CORS 来 实现 公开 。 


8.4 项 目 


下 面 的 项 目 将 演示 如 何 使 用 Jersey 来 返回 JSON，XML， 或 者 JSONP 内 容 。 在 这 个 Hello 
World 式 的 应 用 中 只 用 到 了 一 个 资源 (greeting)。 该 项 目 已 经 公布 在 Github (http://bit.ly/ 
LXhEB8) 上 。 









































8.4.1 运行 项 目 
这 个 项 目 被 设 定 为 从 Maven 中 运行 一 个 Java 类 。 这 个 类 包含 一 个 主要 的 方法 ， 在 本 地 的 
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8080 端口 启动 一 个 HTTP 服务 。 一 个 简单 的 命令 可 以 用 于 构建 和 运行 这 个 程序 : 


mvn clean install exec:java 


8.4.2 ”服务 端 代码 

服务 端 代 码 包 含 了 三 个 Java 类 。App.java 包含 运行 服务 的 main 方法 。 它 创建 了 一 个 
GrizzlyHTTP 服务 的 实例 并 且 定 义 了 /api 作为 Web 接口 环境 的 根 路 径 。 紧 接着 它 添加 了 
一 个 静态 的 HTTP 处 理 程序 ， 用 于 响应 HTML 及 JavaScript 代码 : 








package com.saternos.jsonp; 


import org.glassfish.jersey.grizzly2.httpserver.GrizzlyHttpServerFactory; 
import org.glassfish.jersey.server.ResourceConfig; 
import org.glassfish.grizzly.http.server.*; 


public class App { 
public static void main(String[] args) throws java.io.IOException{ 


HttpServer server = GrizzlyHttpServerFactory.createHttpServer( 
java.net.URI.create("http://localhost:8080/api"), 
new ResourceConfig(GreetingResource.class) 


); 


StaticHttpHandler staticHttpHandler = 
new StaticHttpHandler("src/main/webapp"); 
server .getServerConfiguration().addHttpHandler(staticHttpHandler, "/"); 


Systenm.in.read(); 
server .stop(); 


} 
} 


GreetingBean 是 一 个 与 演 染 XML 响应 内 容 相关 的 、 包 含 注 解 的 POJO: 


package com.saternos.jsonp; 
import javax.xml.bind.annotation.*; 


@XmlRootElLement(name = "greeting") 
public class GreetingBean { 


QXmLAttribute 
public String text; 


public GreetingBean() {} 


public GreetingBean(String text) { 
this.text = text; 
} 
} 
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GreetingResource 提供 了 一 种 能 力 ， 可 以 透 过 服务 器 返回 GreetingBean 包含 的 数据 。 
Jersey (https://jersey.java.net/) 是 JAX-RS 的 参考 实现 ， 它 会 将 Web 请 求 映 射 到 Java 的 方 
法 之 上 。JAX-RS 支持 将 注解 应 用 在 Java 对 象 之 上 。 注 解 是 到 Java 的 1.5 版 本 才 被 支持 
的 。 它 们 被 使 用 在 框架 内 适用 于 约束 类 和 方法 的 行为 ， 并 且 有 效 地 减少 了 完成 常见 任务 所 
需要 的 代码 量 。 这 些 注 解 有 效 地 提供 了 DSL， 它 可 以 很 明确 地 映射 到 HTTP 下 面 的 功能 。 











@GET 注解 表示 了 视图 中 的 HTTP 请 求 动词 。@Path 描述 了 环境 的 URL 地址， 而 @Produces 
则 描述 了 由 Jersey 在 方法 中 返回 bean 的 时 候 会 产生 什么 样 的 内 容 类 型 。@QueryParanm 被 用 
于 指定 getGreeting 方法 的 请 求 参 数 。 表 8-3 介绍 了 典型 的 注解 。 





表 8-3: 部 分 JAX-RS 注 解 
































@GET 表示 请 求 资源 

@POST 在 指定 URI 地 址 创建 资源 

@PUT 在 指定 URI 地 址 创建 或 更 新 资源 
@DELETE 删除 资源 

@HEAD 除了 不 包含 内 容 主 体外 ， 和 GET 一 致 
@Path 资源 的 相对 路 径 

@Produces 用 于 标识 服务 器 返回 的 媒体 类 型 
QConsumes 用 于 指明 服务 器 可 以 接受 的 媒体 类 型 
@Pathparam 将 URI 路 径 参 数 绑 定 到 方法 上 
@QueryParam 将 请 求 参数 绑 定 到 方法 上 

@Formparam 将 表单 参数 绑 定 到 方法 上 








在 JAX-RS 中 还 有 一 些 其 他 的 注解 ， 详 情 请 参见 RESTfil Java with JAX-RS (http://oreil.ly/ 
RestfulJava-JAX-RS, O’Reilly) : 


package com.saternos.jsonp; 


import org.gLassfish.jersey.server.JSONP; 
import javax.ws.rs.*; 


@Path("greeting") 
public class GreetingResource { 


@GET 
@Produces({"application/xml", "application/json"}) 
public GreetingBean getGreeting() { 

return new GreetingBean("Hello World Local"); 


@Path("remote") 
@GET 
@Produces({"application/x-javascript"}) 
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@JSONP(queryParam = JSONP.DEFAULT_QUERY) 

public GreetingBean getGreeting( 
QQueryParam(]JSONP.DEFAULT_QUERY) String callback 
){ 


return new GreetingBean("Hello World Remote"); 


8.4.3 Curl 和 jQuery 

包含 在 项 目 中 的 客户 端 代 码 使 用 jQuery (http://jquery.com/) 去 调用 API 的 URL 路 径 。 
jQuery 类 库 有 丰富 的 Ajax 功能 ， 并 且 将 与 JavaScript XMLHTTPRequest 核心 对 象 相关 的 使 
用 复杂 度 及 跨 浏览 器 挑战 性 隐藏 了 起 来 。 


在 应 用 程序 中 的 调用 可 以 通过 Curl 来 重复 ， 如 下 所 示 。 表 8-4 展示 了 本 例 中 用 到 的 Web 
API URL 路 径 。 











表 8-4: 应 用 程序 地 址 

















地 址 描述 

/ Web 应 用 中 HTML 以 及 JavaScript 的 目录 
/api/greeting 来 自 getGreeting() 的 JSON 或 者 XML 数据 
/api/greeting/remote 来 自 getGreeting() 的 JSON 回调 字符 串 





Curl 可 用 于 返回 一 个 页 面 的 HTML 代码 : 
curl http://LocaLhost:8080 


当 使 用 Curl 时 ， 可 以 指定 参数 -i 来 包含 头 部 信息 。HTTP 响应 的 状态 码 以 及 内 容 类 型 特 
别 值得 关注 。 例 如 ， 如 果 你 指定 了 一 个 不 存在 的 服务 器 地 址 ， 它 将 会 返回 “ 找 不 到 页 面 ” 
的 信息 : 
































curl http://LocaLhost:8080/api -i 


默认 情况 下 应 用 程序 会 返回 XML 内 容 : 





curl http://LocaLhost:8080/api/greeting 
通过 修改 HTTP Accept 请 求 头 ， 则 会 返回 JSON 的 内 容 : 


curl http://LocaLhost:8080/api/greeting -H 'Accept: appLication/json' 





最 后 ， 返 回 JSONP 的 调用 通常 包含 一 个 JavaScript 函数 名 作为 指定 的 查询 参数 。 这 些 调用 
样 的 由 JavaScript 函数 填充 的 JSON 调用 的 结果 。 由 于 JavaScript 文件 可 以 从 不 同 的 
域 下 载 ， 因 此 这 些 内 容 能 够 被 返回 。 如 果 不 这 样 做 ， 它 们 会 被 JavaScript 的 同 源 策略 禁止 : 
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curl http://LocaLhost:8080/api/greeting/remote?__ caLLback=myCaLL 
curl http://127.0.0.1:8080/api/greeting/remote?__callback=myCall 


8.5 ”实践 理论 





单纯 从 理论 上 来 说 ，REST 是 非常 理想 的 标准 。 它 可 以 作为 项 目 是 否 遵循 它 的 规划 来 实现 


的 度量 手段 。 它 应 该 能 被 研究 和 理解 。 其 他 技术 的 价值 ， 比 如 JSON 也 已 被 证 明 。 基 于 
JavaScript 的 客户 端 可 以 很 容易 地 使 用 JSON。 即 便 JSON 缺少 被 普遍 认可 的 链接 机 制 ， 也 
没 能 阻挡 开发 者 选择 它 用 于 数据 传输 的 热情 。 补 充 这 些 API 和 文档 是 与 其 他 实际 上 的 考虑 
有 所 不 同 的 ， 前 者 构建 了 一 个 完美 的 理论 系统 ， 但 它 从 未 落 ， 后 者 作为 实际 的 解决 方案 满 
足 了 切实 的 需求 。 





随 着 时 间 的 扒 


E 移 ， 开 发 者 们 





























下 对 了 很 多 RESTful Web API 对 于 实际 问题 的 适应 症 ， 这 进而 














改变 了 架构 的 方法 。 这 些 API 可 以 被 有 各 种 能 力 的 设备 所 使 用 ， 甚 至 包括 那些 由 第 三 方 开 
发 者 所 创建 的 设备 。 它 比 SOAP 更 加 轻 量 ， 而 其 他 的 Web 服务 实现 差不多 都 有 着 复杂 的 
封包 格式 和 交换 模式 。 它 可 以 用 于 创建 应 用 ， 而 不 会 对 客户 端 上 的 过 时 数据 造成 问题 。 它 
有 效 地 分 发 进程 ， 处 理 有 显著 计算 能 力 的 客户 端 。 当 部 署 在 云 平 台 (如 Amazon Web 服 
务 ) 时 ， 可 以 简单 地 增加 额外 服务 器 来 横向 扩展 应 用 。 这 些 以 及 其 他 一 些 特性 使 得 开发 者 
从 偶尔 实现 或 使 用 服务 变 为 使 用 一 致 的 RESTful Web API 来 开发 完整 的 应 用 。 
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jQuery 和 Jython 





“语言 对 我 们 了 解 世 界 而 言 已 经 非常 重要 ， 而 不 再 只 是 简单 的 辅助 手段 。 对 世间 
万 物 而 言 ， 词 汇 也 不 仅仅 是 声音 标记 与 交流 的 次 要 个 加 。 它 们 是 社会 交流 的 汇聚 
成 果 ， 以 及 人 类 世界 组 成 和 表达 的 基本 工具 。 这 是 20 世纪 人 类 对 语言 的 典型 观 
点 ， 它 呐 穿 了 人 类 科学 发 展 的 整个 历程 。 





一 一 罗 伊 .哈里 其 


编程 语言 已 经 对 人 们 的 生活 方式 产生 了 直接 而 切实 的 影响 ， 这 包括 它们 的 使 用 者 ， 也 包括 
那些 其 至 都 没有 意识 到 它们 的 存在 的 人 。 有 趣 的 是 ， 程 序 员 通常 很 少 会 花 时 间 去 做 跟 语言 
基本 特性 有 关 的 工作 。 在 弄 明 白 这 些 之 后 ， 他 们 会 立刻 尝试 避免 重复 的 无 用 功 ， 抽 象 层 
( 泛 化 ) 会 变 得 非常 受 欢 迎 ， 近 平成 为 原始 语言 的 一 部 分 。 





JavaScript 相关 的 jQuery 库 就 是 这 样 的 一 种 技术 。 它 已 经 被 广泛 使 用 ， 大 部 分 JavaScript 开 
发 者 都 在 使 用 。 有 些 观点 认为 它 不 只 是 一 个 库 ， 而 更 像 是 一 种 内 部 DSL (内 部 领域 专用 语 
言 )。 这 种 观点 认为 jQuery 是 一 个 聚焦 于 DOM 操作 、Ajax 处 理 和 其 他 通用 JavaScript 任 
务 的 小 型 语言 。 无 论 如 何 ，jQuery 使 用 得 如 此 普遍 ， 以 至 于 你 会 在 网 上 发 现 每 当 有 人 问 
“如 何在 JavaScript 中 使 用 X”， 答 案 常 以 jQuery 风格 给 出 。 












































分 层 抽象 让 Java 的 底层 比 该 语言 自身 更 加 成 功 。 正 如 Java 虚拟 机 (JVM)， 它 处 理 Java 
编译 器 产生 的 字 节 码 ，Java 从 一 开始 就 特意 设计 JVM 为 一 个 抽象 层 。 因 其 独立 的 存在 ， 
使 得 将 其 他 非 Java 语言 编译 到 JVM 上 运行 成 为 可 能 。JVM 是 一 个 精心 设计 、 高 性 能 的 
程序 ， 是 多 年 研发 的 成 果 。 就 算 开 发 人 员 对 Java 语言 没有 兴趣 ， 但 仍 会 从 这 项 基础 技术 


9 
上 受益 。 
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本 章 创 建 的 项 目 将 使 用 jQuery 和 Jython (一 种 基于 JVM 的 Python 实现 ) 来 演示 一 个 简单 
的 C/S Web 应 用 原型 。 


9.1 服务 端 : Jython 


Python (https://www.python.org/) 最 初 由 Guido van Rossum (主要 作者 和 该 项 目的 BDFL 一 一 
仁慈 的 独裁 者 ，Benevolent Dictator For Life) 发 布 在 20 世纪 90 年 代 中 期 。Python 因 其 清 
晰 、 可 读 性 强 、 语 法 规整 出 名 ， 和 C 语言 的 风格 〈 比 如 括号 ) 不 同 。 因 为 它 的 一 致 性 和 清 
晰 性 ， 它 已 经 在 很 多 教育 机 构 作 为 编程 语言 授课 的 入 门 语言 。Python 通常 比 Java 使 用 更 少 
的 代码 完成 相同 的 任务 。 











Jython (http://www.jython.org/) 是 一 个 运行 在 JVM 上 的 Python 实现 。 这 使 得 能 在 安装 了 
Java 的 环境 上 创建 清晰 简洁 的 Python 代码 。Jython 同样 可 以 和 Java 对 象 交 互 ， 它 引入 了 
一 系列 矢 入 Jython 或 与 原生 Java 库 连 结 的 能 力 。 








9.1.1 Python Web 服务 器 
作为 一 种 脚本 语言 ，Python 同样 也 能 以 Java 开发 人 员 不 熟悉 的 方式 使 用 。 例 如 ， 运 行 一 个 
静态 Web 服务 器 ， 它 不 用 编写 一 行 原始 代码 ， 就 可 以 在 任何 目录 提供 文件 服务 。 你 可 以 简 
单 地 切换 到 一 个 目录 ， 然 后 调用 如 下 指令 : 








python -m SimpleHTTPServer 


9.1.2 Jython Web 服 务 器 
使 用 上 面 提 到 的 simpleHTTPServer 创建 基于 Python 的 Web 服务 器 只 需要 几 行 代码 : 














import SimpLeHTTPServer 
import SocketServer 
import os 


os.chdir('src/main/resources') 

httpd = SocketServer.TCPServer(("", 8000), 
SimpleHTTPServer .SimpleHTTPRequestHandler) 
print "serving at port 8000" 

httpd. serve_forever() 


Jython 可 以 从 命令 行 调 用 也 可 以 嵌入 Java 应 用 中 。 例 如 这 个 从 Java 类 中 调用 的 脚本 : 
package com.oreilly.jython; 
import java.io.File; 
import java.io.IOException; 


import org.python.util.PythonInterpreter; 
import org.apache.commons.io.FileUtils; 





A 
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public class Server 


{ 

public static void main( String[] args ) throws IOException 

{ 

new PythonInterpreter().exec( 
FileUtils.readFileToString( 
new File("python/http_server.py") 
) 
人 

} 

} 


项 目 及 其 依赖 可 以 在 Github (https://github.com/java-javascript/client-server-web-apps/tree/ 
master/Chapter-9-jQuery-and-Jython/jython-json-REST/rest-json) 上 获得 。 它 可 以 使 用 mvn 
clean install 构建 ， 使 用 mvn exec:java 运行 。 





9.1.3 Mock API 

静态 Web 服务 器 有 明显 的 局 限 性 。 对 于 Web App 开发 者 最 为 显著 的 问题 是 它 不 能 产生 动 
态 数 据 。 然 而 ， 可 以 简单 地 创建 一 个 包含 典型 数据 的 文件 去 模拟 这 些 API。 例 如 ， 一 个 名 
字 叫 api 的 目录 里 面 有 一 个 叫 groups.json 的 文件 ， 它 可 以 用 URL http://localhost:8000/api/ 
groups.json 来 访问 。 这 个 JSON 文件 的 内 容 是 groups (分 组 ) 的 数组 ， 每 个 对 象 都 拥有 名 
称 (name)、 描 述 (description) 和 URL: 








[ 


"name":"duckduckgo", 
"description":"Internet search engine founded by Gabriel Weinberg", 
"url":"http://duckduckgo.com/" 


}, 
{ 
"Name":"angular", 
"description":"Open source JavaScript framework initially created"+ 
" by Adam Abrons and Misko Hevery", 
"url":"http://angularjs.org/" 
上} 
{ 
"name":"twitter", 
"description":"Online social networking service and microblogging"+ 
" service created by Jack Dorsey", 
"url":"http://twitter .com/" 
}， 
{ 
"name":"netflix", 
"description":"American provider of on-demand Internet streaming"+ 
"media Marc Randolph and Reed Hastings", 
"url":"http://netflix.com/" 
} 
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URL 路 径 中 会 映射 出 相对 于 根 路 径 的 目录 ， 如 果 指 定 了 相应 的 扩展 名 ,许多 Web 服务 
器 会 返回 期 望 的 内 容 类 型 。 在 服务 器 端 配 置 及 开发 的 过 程 中 ， 客 户 端 开发 人 员 可 以 通过 
Mock API 进行 并 行 开发 。 





9.2 客户 端 : jQuery 

自 2006 年 发 布 以 来 ，jQuery 在 诸多 方面 简化 了 跨 浏览 器 开发 。 它 由 John Resig 创建 ， 意 
图 改变 开发 者 编写 JavaScript 的 方式 。 有 具体 来 讲 ， 它 追求 消除 重复 工作 ， 令 模糊 、 烦 琐 的 
JavaScript 变 得 清晰 、 简 洁 。 






































在 初次 邂逅 jQuery 时 ， 代 码 中 出 现 的 美元 符号 令 人 惊讶 。 这 是 因为 $ 代表 了 jQuery 对 象 
在 库 中 的 命名 空间 。 所 以 它 等 价 如 下 : 





jQuery('a') 

$('a') 
在 标准 的 用 法 中 ，JavaScript 在 内 容 体 的 ontoad 事件 执行 后 ， 即 页 面 加 载 后 运行 。Load 事 
件 会 在 页 面 全 部 呈现 完成 后 触发 (包括 全 部 资源 ， 如 图 片 )。jQuery 提供 了 一 个 可 以 更 早 
运行 的 事件 ， 就 是 在 DOM 就 绪 之 后 。 注 册 这 个 事件 的 处 理 程 序 ， 有 具体 包括 几 种 不 同 的 语 
法 ， 例 如 以 下 版 本 : 









































$s(document).ready(function() { 
//.ready() 调 用 函数 
]); 


等 同 于 : 


$s(function() { 

人 国 数 
一 般 模 式 是 使 用 jQuery 查找 DOM 元 素 并 对 其 加 以 处 理 。 使 用 某 些 类 型 的 模式 字符 串 
(CSS 选择 器 或 XPath) 来 查找 DOM 元 素 。 处 理 的 方式 ， 可 以 是 简单 地 读 取 元 素 的 内 容 ， 
或 涉及 它 的 内 容 、 样 式 ， 或 通过 事件 的 处 理 程序 联系 行为 。jQuery 同样 提供 了 一 个 一 致 的 
Ajax 处 理 接口 ， 同 样 也 设计 了 插件 机 制 来 扩展 自身 。 












































9.2.1 DOM 人 遍历 和 操作 

多 数 对 JavaScript 的 批评 主要 集中 在 它 对 浏览 器 DOM 的 交互 上 。jQuery 简化 了 HTML 
与 JavaScript 的 交互 ， 为 DOM 选择 、 遍 历 、 操 作 提 供 了 优雅 的 接口 。 这 里 最 常用 的 是 
CSS1-3 的 CSS 选择 器 ， 以 及 一 些 jQuery 的 特殊 特性 。CSS 选择 器 是 一 种 包含 模式 匹配 的 
字符 串 ， 通 过 标签 名 或 者 一 系列 复杂 的 匹配 条 件 可 以 轻易 地 匹配 到 任何 一 个 HTML 元 素 。 
如 果 给 定 的 元 素 能 够 匹配 到 某 个 模式 的 所 有 条 件 ， 这 个 选择 器 就 可 以 将 这 个 元 素 匹 配 出 
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来 。 表 9-1 给 出 了 一 些 jQuery 的 例子 。 





表 9-1: jQuery 的 例子 
选择 器 描述 
SC'Sdiv ' ) 全 部 的 div 


$('#myElement') 
$s('.myClass') 


ID 为 myELement 的 元 素 
全 部 Class 为 myCLass 的 元 素 
ID 为 myDiv 的 元 素 

Class 为 UL.myListCLass 


$('div#myDiv') 
$('ul.myListClass 1i') 的 ut 下面 的 列表 项 


Class 为 projects 的 ul 中 的 第 一 个 列表 项 





SC'uUL.projects li:first') 











表 9-2 中 展示 了 其 他 属性 同样 也 可 以 被 访问 ， 哪 怕 只 知道 部 分 的 值 也 可 以 将 它们 找 出 来 。 
表 9-2: jQuery 的 部 分 值 
选择 器 描述 





$s('input[name*="formInput"]') 





name 有 formInput 子 串 的 Input 元 素 
$('input[name^="formInput"]') name 开始 于 formInput 的 Input 元 素 





有 特殊 意义 的 字符 必须 使 用 两 个 反 斜 杠 
输入 字段 ， 下 面 的 选择 器 用 来 识别 它 





来 转 义 。 例 如 ， 一 个 ID 为 myForm:username 的 文本 














$('input#myForm\\:username') 














CSS 选择 器 非常 有 表现 力 ， 但 有 时 得 到 的 对 象 数 组 结 
jQuery 方法 会 返回 一 个 jQuery 对 象 ， 你 可 以 继续 调用 
DOM 子 树 寻 找 一 个 特殊 元 素 : 


果 还 需要 做 进一步 的 处 理 。 许 多 
其 他 的 方法 。 比 如 这 个 例子 ， 从 一 个 








sS(C'div.projects' ).ftnd(' .project1') 


9.2.2 ”实用 函数 

jQuery 同时 也 提供 了 一 些 用 来 处 理 类 似 元 素 集 合 的 实用 函数 (http://api.jquery.com/category/ 
utilities/) ， 参 见 表 9-3。underscore.js 这 样 的 类 库 与 jQuery 有 所 重 倒 ,但 其 提供 了 更 多 处 理 
列表 和 对 象 的 能 力 ， 随 着 时 间 的 推移 JavaScript 也 增加 了 类 似 的 方法 ， 因为 要 兼容 古老 的 
浏览 器 ， 所 以 jQuery 的 方法 在 短期 内 应 该 会 被 继续 使 用 。 


表 9-3: 实用 函数 






































寺 

















jQuery Underscore JavaScript 1.6 
迭 代 each each forEach 
变换 map map map 
过 滤 grep filter、 where 
索引 查找 inArray indexof 、LastIndexOf 
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在 一 个 对 象 被 定位 后 通常 会 要 做 些 琐碎 的 事情 ， 函 数 的 链 式 调用 会 让 操作 元 素 变 得 特别 


方便 : 


$('div.items').find('.item1').text('Hi World').css('background-color', 'blue') 


通过 修改 DOM 中 的 特定 元 素 ， 可 以 开发 出 响应 用 户 动作 的 动态 交互 用 户 界 卫 








“查找 一 个 元 素 ” 然 后 “做 点 什么 ”这 种 模式 非 


池 A 


而 间 ] 
要 在 一 个 引入 了 jQuery 的 页 面 上 打开 浏览 器 控制 


口 ， 

















单 、 强 大 、 直 观 。 令 人 欣慰 的 是 ， 
F 始 写 入 选择 器 就 可 以 返回 





然后 


























口 


AAA 


对 


象 。 当 定位 到 你 要 找 的 元 素 之 后 ， 可 以 尝试 对 它 的 文字 或 样式 进行 修改 。 如 果 你 希望 在 没 








有 引入 jQuery 的 页 玫 








ij 也 这 样 做 ， 你 可 以 按照 下 画 











var script= document.createElement('script'); 





script.type= 'text/javascript'; 


script.src= 'http://ajax.googleapis.com/ajax/\libs/jquery/1.9.1/jquery.min.js'; 
p p J goo0og p J Jquery Jquery ] 


document .head.appendChiLd(script); 


9.2.3 ”效果 





i 的 方式 来 做 : 





jQuery 拥有 便捷 的 方式 可 以 通过 改变 CSS 来 显示 或 隐藏 元 素 。 它 还 包含 一 些 与 动画 相关 的 
方法 ， 例 如 渐 隐 渐 现 和 请 动 效果 : 


$('form#myForm 
$('form#myForm 
$('form#myForm 
$('form#myForm 
$('form#myForm 
$('form#myForm 


'). 
'). 
'). 
'). 
'). 
'). 


hide() 

show() 
slideUp('slow') 
slideDown('slow') 
fadeIn('slow') 
fadeOut('slow') 


9.2.4 事件 处 理 
jQuery 选择 器 可 以 用 来 向 指定 的 元 素 绑 定 事件 处 理 器 。 随 着 时 间 的 推移 ， 实 际 使 用 的 语法 
已 经 有 所 变化 。 像 btnd、Live 和 delegate 之 类 的 方法 已 经 被 on 和 off 所 取代 。 动 态 接口 





的 增多 带 来 的 一 个 挑战 是 : 你 可 能 需要 定义 事件 处 到 
元 素 。 解 决 方案 就 是 : 在 更 高 层 的 DOM 上 绑 定 这 























器 ， 用 来 处 到 








事 付 

















用 户 交 互 过 程 中 生成 的 


EB 








F。 当 事件 被 触发 时 ， 尽 管 这 个 二 


月 - 


件 并 没有 直接 关联 到 这 个 元 素 上 ， 但 它 仍然 会 向 上 传递 ， 直 到 匹配 到 合适 的 选择 器 ， 然 后 


进行 处 理 ， 





$(document).on('click','.myClass', function(){ 


console.log(' 点 人 家 做 哈 啦 '); 


}); 


9.2.5 Ajax 


jQuery 将 XMLHttpRequest 浏览 器 对 象 封 装 得 更 简单 易 用 ， 在 不 同 浏 





下 表现 一 致 。 





A 
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jQuery.ajax 是 一 个 通用 的 Ajax 请 求 器 ， 可 以 简单 方便 地 应 用 于 HITP GET 和 POST 方 
法 。 由 于 在 Ajax 应 用 中 JSON 通讯 的 普及 ， 它 提供 了 get]JSON 方法 ， 同 时 还 提供 了 通过 
JSONP 来 创建 调用 的 能 








jQuery 是 一 个 出 色 而 且 简洁 的 库 。 本 章 着 重 于 概括 地 介绍 它 的 大 部 分 设计 理念 。 至 于 如 何 
进一步 用 jQuery 来 解决 特定 问题 ， 可 以 参考 Cody Lindley 的 jQuery Cookbook (http://oreil. 
ly/jquery-ckbk，O’Reilly) 等 书 。 


9.3 jQuery 和 更 高 级 的 抽象 


jQuery 极 大 地 简化 了 跨 浏 览 器 开发 ， 使 得 带 有 重 Ajax 交互 、 事 件 处 理 和 DOM 操作 的 Web 
应 用 的 开发 变 得 更 加 简单 。 它 的 受 欢迎 度 (http://trends.builtwith.com/javascriptjQuery) 表 
明 它 还 还 会 在 很 多 年 内 继续 流行 且 持 续 影响 。 但 是 随 着 Web app 应 用 规模 的 增 大 ， 为 了 降 
低 复杂 度 ， 新 的 方法 出 现 了 。 更 大 尺度 的 设计 模式 (MVC) 和 编程 范式 (函数 式 编程 ) 成 
为 了 jQuery 中 部 分 功能 的 替代 及 补充 。 

举例 来 说 ， 给 变量 赋值 这 一 简单 的 场景 ， 这 种 基本 任务 也 会 随 着 程序 中 (互相 依赖 的 ) 变 
量 的 增长 而 变 得 繁重 。 而 在 面向 对 象 的 编程 中 ， 一 个 对 象 可 以 封装 一 组 变量 ， 用 来 表示 这 
个 对 象 的 状态 。 可 以 给 这 个 对 象 定义 方法 来 访问 和 改变 它 的 状态 。 





















































在 JavaScript 社区 ， 流 行使 用 其 他 方法 而 不 是 (传统 意义 上 的 ) 面向 对 象 来 解决 变量 同步 
的 问题 ， 在 模型 和 视图 组 件 之 间 进 行 双向 数据 绑 定 (AngularJS) ， 以 及 随 着 时 间 的 推移 定 
义 表示 值 的 数据 类 型 的 响应 式 编程 (而 不 只 是 关心 特定 时 刻 的 变量 的 值 )。 









































函数 响应 式 编程 
函数 响应 式 编程 〈(Functional Reactive Programming，FRP) 是 一 种 最 近 广 受 关注 的 GUI 
设计 的 声明 方式 。 它 的 亮点 在 于 许多 通过 jQuery 直接 声明 的 构造 (事件 处 理 器 、 回 调 
和 DOM 操作 ) 并 非 直接 完成 的 。 














jQuery 也 有 它 的 局 限 性 ， 所 以 在 客户 端 模板 、 模 块 化 代码 、 回 调 管 理 上 有 更 加 完善 的 独立 
项 目 如 雨后春笋 一 般 出 现 ， 它 们 设法 简化 直接 操作 DOM 的 复杂 度 ， 多 数 都 可 以 和 jQuery 
一 起 使 用 。jQuery 成 功 地 改善 了 六 览 器 不 兼容 的 问题 ， 为 DOM 操作 提供 了 统一 接口 ， 使 
它 成 为 了 JavaScript 开发 中 不 可 缺少 的 一 部 分 。 


9.4 项目 


在 本 章 前 面 介绍 过 的 基于 Jython 的 HITP 服务 器 ， 会 简单 地 对 特定 目录 内 文件 的 请 求 进 
行 响 应 。 这 用 来 响应 HTML 和 JavaScript 文件 已 经 足够 了 。 尽 管 服务 器 本 身 提 供 的 功能 很 
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少 ， 我 们 仍然 有 办 法 通过 调用 第 三 方 API 来 扩展 服务 器 层 。 一 个 可 以 公开 使 用 且 不 需要 特 
别 设置 的 API， 或 者 密 钥 是 GitHub API 的 API。 述 的 应 用 可 以 完成 从 在 GitHub 中 








查找 数据 到 展现 项 目 成 员 的 任何 事情 (如 图 9-1 所 示 )。 
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9-1: GitHub 组 


9.4.1 基础 HTML 


这 个 应 用 可 以 由 一 个 包含 内 骨 CSS 的 简单 HTML 文件 从 头 开 始 “构建 ”出 来 。 在 以 这 种 
方式 开发 时 ， 把 所 有 的 代码 都 放 在 同一 个 视图 里 会 更 简单 ， 不 过 在 生产 项 目 中 ， 样 式 表 最 
好 是 外 置 的 (和 之 前 无 侵入 性 JavaScript 相关 的 讨论 吻合 ， 关 于 “不 可 见 JavaScript”， 请 





参见 http://en.wikipedia.org/wiki/Unobtrusive_JavaScript) 。 


<htmL> 
<head> 
<title> 索 3|</title> 
<style type="text/css" media="screen"> 
img {width: 50; height: 50;} 
span {padding: 7px;} 
</style> 
</head> 
<body> 


<select id="selected group"> 
<option> 选 择 组 </option> 
</select> 
<div id="images"></div> 
</body> 
</htmL> 


9.4.2 JavaScript 和 jQuery 
在 闭合 的 </style> 标签 之 后 添加 来 自 Google CDN 的 jQuery 引用 : 


<script src="//ajax.googleapis.com/ajax/libs/jquery/1.8.3/jquery.min.js"> 
</script> 








下 拉 菜 单 的 选项 列表 ， 会 以 JSON 文件 的 形式 被 提前 加 载 。 





以 下 的 jQuery 代码 会 载 人 这 个 JSON 文件 调用 $.9etJSON， 然 后 循环 访问 每 个 返回 的 
记录 并 将 选项 添加 到 这 个 选择 元 素 上 。 每 当 一 个 选项 被 选中 时 ， 函 数 getGroup() 就 会 被 
调用 : 





<script> 


$.getJSON("/api/groups.json", 
function(data) { 
$.each(data, function(i,item){ 
$("<option>"+item.name+"</option>"). 
appendTo("#selected_ group"); 
]); 
}) .error(function(){ console.log(" 错 误 ");}); 


$(document).ready(function() { 
$('#selected group').bind('change', 
function (){ 
getGroup(); 
]); 
]); 


</script> 


函数 getGroup() 清除 之 前 的 显示 ， 然 后 发 送 一 个 请 求 到 GitHub 来 获取 选中 组 织 的 数据 。 
随后 每 个 组 织 成 员 的 名 字 和 头像 便 会 显示 出 来 。 


function getGroup(){ 
$("#images").empty(); 
$.getJSON("https://api.github.com/orgs/" + 
$('#selected group').val() + "/members", 
function(data) { 
$ .each(data, 
function(i,item){ 
$("<span>" + 
item.login + 
"</span><img/>"). 
attr("src", item.avatar_url). 
appendTo("#images" ); 
]); 
}) .error(function(){ consoLe.Log( "错误 "); }); 











这 个 例子 展示 了 使 用 jQuery 调用 本 地 或 远程 API 来 显示 结果 是 非常 容易 的 。 整 个 客户 端 
仅仅 包含 了 不 到 40 行 的 HTML、CSS 和 JavaScript 代码 。jQuery 提供 了 良好 的 跨 浏 览 器 支 
持 ， 显 然 ， 这 也 就 是 它 能 够 这 么 快速 并 且 广 泛 地 得 到 采用 的 原因 。 











这 就 是 说 ， 这 个 项 目 不 会 在 不 同 的 设备 上 有 特别 好 或 者 特别 差 的 响应 。 含 有 HTML 片段 
的 字符 串 可 能 会 让 你 觉得 不 适 ， 并 且 和 希望 得 到 某 种 用 模板 来 解决 的 方案 。 你 也 可 能 会 觉得 
使 用 瞬 套 函数 有 点 外 行 ， 可 能 会 有 一 种 方式 以 更 自然 的 函数 语法 来 调用 它 。 你 不 是 第 一 个 
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有 这 种 反应 的 。JavaScript 世界 已 经 对 此 开发 了 相应 的 项 目 和 库 ， 我 们 会 在 稍 后 的 章节 讨 
论 到 。 


9.5 小 结 


以 客户 端 - 服务 器 的 方式 进行 Web 开发 只 需要 几 分 钟 的 初始 设置 。 本 章 中 包含 的 服务 器 
项 目 仅仅 服务 于 静态 资源 。 静 态 HTML 文件 和 存储 在 JSON 文件 里 的 模拟 API 调用 可 以 创 
建 在 文件 系统 上 ， 不 需要 编译 就 能 更 新 。 创 建 完成 后 ，jQuery 就 可 以 被 用 来 创建 本 地 或 远 
程 API 调用 并 显示 结果 。 这 种 性 质 的 项 目 并 不 需要 很 深入 的 Java 或 者 Python 知识 ， 也 只 
有 很 少 的 JavaScript 知识 需要 掌握 。 结 论 就 是 : 一 个 简单 的 动态 Web 应 用 可 以 被 不 同 种 类 
的 浏览 器 显示 。 
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JRuby 和 Angular 





“我 们 生活 的 世界 美丽 动人 且 秩 序 井然 尽管 它 有 时 候 看 起 来 混乱 无 常 。” 
一 一 M. C. 埃 会 尔 


自古 以 来 ， 世 间 万 物 都 通过 排序 和 筛选 来 组 织 。 古 代 离 合 诗 ' 的 每 一 行 都 以 字母 开头 。 
这 既 需 要 筛选 (选择 第 一 个 字母 ) 也 需要 排序 ( 按 字母 顺序 排序 )。 10-1 所 示 为 得 
法 (Sieve of Eratosthenes， 又 称 埃 拉 托 斯 特 尼 得 法 ，http:Wen.wikipedia.org/wiki/Sieve 
of _Eratosthenes)， 我 们 可 以 把 它 直观 地 写 出 来 (http:/Wclientserverweb.comy/sieve-of- 
eratosthenes.html) ， 只 需 将 从 2 到 最 大 值 的 所 有 整数 排序 ， 然 后 算 选 掉 其 中 为 质数 倍数 的 
合 数 〈 非 质数 )。 




















图 10-1， 筛 法 
在 网 上 搜索 筛选 和 排序 会 返回 许多 关于 在 表格 程序 中 操作 数据 的 结果 。 本 章 的 项 目 将 展示 











注 1: 离合 诗 ， 每 行 的 某 些 字母 组 合 起 来 能 构成 词 的 一 种 诗 体 。 一 一 译 者 注 
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JRuby 和 Angular 如 何 使 用 相对 较 少 的 代码 ， 对 一 个 包含 谷歌 财经 股市 数据 的 HTML 表格 
进行 筛选 和 排序 。 





10.1 服务 器 端 : JRuby 和 Sinatra 


使 用 Ruby 和 一 个 名 为 Sinatra 的 微型 框架 可 以 创建 简单 、 动 态 的 网 络 API。Sinatra 实质 上 
就 是 一 个 基于 Ruby 的 HTTP 包装 器 。 





Ruby 是 由 松本 行 双 (Yukihiro“Matz”Matsumoto) 开发 的 ， 他 融合 了 他 喜欢 的 多 种 语言 
(Perl、Smalltalk、Eiffel、Ada 和 Lisp)， 开 发 了 这 门 能 平衡 函数 式 和 命令 式 方法 的 新 语言 。 
尽管 松本 行 弘 在 1995 年 就 发 布 了 这 种 语言 ， 并 且 还 在 2001 年 为 其 写 了 一 本 名 为 Ruby in a 
Nutshell 的 书 ， 但 是 直到 数 年 后 Ruby on Rails (或 者 简称 为 Rails) 开始 流行 起 来 它 才 广 为 
人 知 。 用 松本 行 弘 的 话 来 说 ， 这 门 语言 “表面 看 起 来 很 简单 ， 但 内 部 却 十 分 复杂 ， 就 像 我 
们 人 体 的 构造 一 样 "。Matz 最 近 又 与 人 合 著 了 一 本 关于 Ruby 的 书 (http://oreil.ly/ruby-prog- 
lang) 来 深入 探讨 这 门 奇 妙语 言 的 细节 。 












































Rails (http://rubyonrails.org) 是 Ruby 的 MVC 网 络 框 架 ， 它 让 Ruby 第 一 次 得 到 了 许多 开 
发 者 的 注意 。David Heinemeier Hansson 从 Basecamp (他 在 37signals 公司 开发 的 一 个 项 目 
管理 工具 ， 参 见 https://basecamp.com。37signals 公司 网 址 为 http://37signals.com/) 中 提取 
了 这 个 框架 并 于 2004 年 发 布 。 在 许多 语言 和 框架 中 ， 不 写 任何 代码 就 不 会 有 任何 行为 。 
而 在 Ruby (包括 Rails 和 其 他 Ruby 项 目 ) 中 ， 已 经 包含 默认 行为 ， 即 使 不 写 任何 代码 。 
Rails 的 理念 表明 了 这 一 原则 : 约定 高 于 配置 。 这 大 大 减少 了 一 个 项 目 启 动 和 运行 所 需 的 步 
又 。 这 个 原则 在 用 Ruby 编写 的 其 他 网 络 框架 中 也 十 分 明显 ， 特 别 是 Sinatra (http:Wwww. 
sinatrarb.com) 。Sinatra 比 Rails 小 得 多 ， 不 需要 更 大 的 框架 中 的 附属 项 目 ， 非 常 适合 创建 
流线型 应 用 。 



























































10.1.1 工作 流 


一 种 使 用 JRuby (或 者 其 他 JVM 语言 ) 的 方法 是 从 Java 的 角度 将 其 纳入 ， 包 含 该 语言 实 
现 的 模块 可 以 作为 一 个 依赖 引入 到 项 目 中 : 





<dependency> 
<groupId>org.jruby</groupId> 
<artifactId>jruby-complete</artifactId> 
<version>1.6.3</version> 
<type>jar</type> 
<scope>compile</scope> 
</dependency> 


在 Web 应 用 下 ， 如 果 你 已 经 安装 了 Java 应 用 服务 器 ， 这 是 有 效 的 。Warbler (https:// 
github.com/jruby/warbler) 可 以 用 来 将 Rack 应 用 捆绑 到 WAR 文件 上 ， 有 一 些 有 趣 的 试验 ， 














130 | 第 10 章 


比如 Rack Servlet from Square Engineering (http://corner.squareup.com/2013/07/rack-servlet.html) ， 
将 一 个 基于 Ruby 的 服务 器 端 小 应 用 艇 入 到 一 个 现 有 的 WAR 中 。 





以 这 种 方式 使 用 过 Ruby 的 Java 开发 者 将 会 从 关注 语法 差异 中 获 益 ， 但 会 错过 一 些 可 以 
帮助 语言 获得 成 功 的 工具 和 工作 流 。 这 些 差 异 首 先 在 于 用 来 初始 设置 语言 和 相关 软件 包 
的 工具 。 





10.1.2 ”交互 式 Ruby shell 

交互 式 Ruby shell (IRB) 是 可 以 执行 Ruby 命令 的 shell。 它 相当 于 一 个 操作 系统 的 shell， 
它 计 算 的 任何 表达 式 都 能 立即 得 到 结果 。 在 很 多 其 他 语言 中 ， 都 有 这 种 读 取 - 求 值 -输出 
循环 (Read-Eval-Print Loop，REPL) 的 程序 。 当 尝试 和 学 习 一 种 新 语法 ， 或 不 确定 使 用 
什么 算法 和 数据 结构 时 ， 通 常 的 编辑 / 编译 /运行 /调试 过 程 会 非常 烦琐 。Java 没有 任何 
类 似 的 工具 。 当 调试 器 暂停 时 执行 一 些 代码 与 此 类 似 ，Eclipse 集成 开发 环境 中 有 一 个 名 
为 Scrapbook Page 的 功能 也 是 类 似 的 。 在 学 习 Ruby 时 ，IRB 是 值得 研究 的 ， 当 使 用 JRuby 
时 ， 它 也 能 用 来 获取 Java 的 类 。 


关于 如 何 使 用 IRB 来 访问 Java JAR 的 示例 ， 可 参见 附录 A。 


10.1.3” Ruby 版 本 管理 器 


不 同 于 在 Java 项 目 中 将 JRuby 作为 一 个 依赖 来 获取 ，JRuby 环境 可 以 使 用 Ruby 版 本 管 
理 器 (Ruby Version Manager，RVM， 参 见 https:/rvm.io/) 进行 设置 。RVM 不 仅 限 于 
JRuby， 在 其 他 Ruby 项 目 中 也 能 使 用 。RVM 支持 许多 Ruby 环境 的 部 署 。 每 个 RVM 都 是 
自足 的 ， 包 含 了 一 个 特定 版 本 的 Ruby， 并 且 还 和 所 需 的 gem 关联 。RVM 让 项 目 建立 变 得 
容易 ， 因 为 它 包含 一 组 依赖 特定 版 本 Ruby 的 gem 组 ， 并 让 这 些 项 目 独立 于 使 用 其 他 Ruby 
版 本 的 项 目 。 它 是 交互 性 的 ， 并 且 对 安装 过 程 中 的 额外 配置 或 故障 诊断 给 出 了 智能 意见 。 
如 果 你 正在 参与 多 个 Ruby 项 目 ， 它 可 以 让 你 在 一 个 给 定 环境 中 进行 开发 ， 并 能 通过 一 个 
命令 切换 到 另 一 个 环境 。 
























































Ruby/JRuby/RVM/ 依赖 管理 
Ruby 有 多 种 不 同 的 使 用 方式 ， 这 也 是 混乱 的 根源 。 
Ruby 是 一 种 独立 的 编程 语言 。JRuby 是 一 个 能 在 Java 虚拟 机 上 运行 的 Ruby 版 本 。 
RVM 提供 了 对 多 个 不 同 Ruby 版 本 进行 管理 的 机 制 ， 其 中 也 包括 JRuby。RVM 环境 包 
含 了 安装 语言 和 相关 联 的 Ruby 包 ， 并 且 在 项 目 外 的 本 地 机 器 上 维护 。RVM 提供 了 一 
种 从 Ruby 角度 操作 Ruby 项 目的 方式 ， 其 中 也 包括 JRuby。 
JRuby 也 可 以 作为 一 个 标准 的 模块 依赖 被 Maven 或 其 他 构建 工具 引入 。 这 种 情况 不 需 
要 使 用 RVM， 而 是 从 Java 的 角度 对 待 JRuby。 
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J 可 以 使 用 如 下 方式 检测 RVM 当前 使 用 了 哪个 版 本 的 Ruby: 





$ which rvm-auto-ruby 
/Users/cas/.rvm/bin/rvm-auto-ruby 


# 通常 不 能 直接 调用 …… 


$rvm-auto-ruby --version 


# Ruby 的 版 本 和 上 条 命令 的 版 本 相同 


$ruby --version 
列 出 已 经 安装 的 Ruby 解释 器 和 当前 正在 使 用 的 版 本 : 
rvm ls 


为 切换 到 另 一 个 环境 ， 可 以 调用 rvm use 命令 并 跟着 Ruby 解释 器 名 字 的 一 部 分 : 





rvm use 2.0.0 





其 他 RVM 函数 
除了 交互 式 地 维护 Ruby 版 本 ，RVM 还 有 很 多 其 他 功能 。 通 过 它 ， 你 可 以 创建 一 个 
特定 于 项 目的 Ruby 环境 gemsets (https:Wrvm.io/gemsets/basics) ， 使 其 独立 于 其 他 的 
Ruby 项 目 。 它 可 以 在 任何 命令 行 中 被 用 来 执行 特定 Ruby 版 本 和 gemset 的 脚本 。 它 能 
够 提供 的 不 仅仅 是 简单 的 诊断 建议 ， 举 个 例子 ， 有 时 候 通过 运行 下 面 的 RVM 命令 可 
以 很 轻松 地 解决 SSL 证 书 问题 ; 


rvm osx-ssl-certs Update all 











10.1.4 包 

Ruby 的 包 叫 作 gem， 通 过 gen 实用 工具 进行 维护 。gem 可 以 用 不 同 的 版 本 来 发 布 ， 一 个 项 
目 可 以 使 用 一 组 相对 特定 的 依赖 关系 来 开发 。 一 组 gem 可 以 关联 一 个 单独 的 RVM 环境 ， 
允许 多 个 使 用 不 同 Ruby 版 本 和 不 同 gem 组 的 Ruby 项 目 同 时 开发 。 为 了 把 一 个 给 定 的 项 
目 部 署 到 其 他 机 器 上 ， 特 定 的 依赖 组 可 以 使 用 打包 gem (http://bundler.io) 声明 式 的 维护 。 
打包 的 依赖 列 在 Gemfile 中 。 


使 用 RVM， 可 以 创建 一 个 新 的 Ruby 环境 。 之 后 可 以 独立 安装 一 组 gem， 并 且 调 试 环境 ， 
直到 所 有 的 正确 依赖 和 版 本 都 是 可 用 的 。 然 后 ， 将 当前 环境 使 用 的 所 有 版 本 信息 补充 到 打 
包 的 Gemfile 中 。 下 面 的 bash 命令 可 以 用 来 创建 一 个 新 的 Gemfile， 其 中 添加 了 一 条 注释 
说 明 当 前 使 用 的 Ruby 版 本 ， 并 包括 了 符合 当前 环境 的 一 组 gem。 大 部 分 工作 都 在 最 后 一 
条 命令 中 完成 ， 它 列 出 了 当前 环境 可 用 的 所 有 gem， 格 式 化 了 列表 ， 移 除了 rvn 和 bundle 
的 引用 ， 并 使 用 这 个 列表 来 创建 有 统一 gem 入 口 的 Gemfile。 
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#!/bin/bash 
bundle init 


echo "# Ruby Version: ‘ruby --version ">>GemfiLLe 


gem list --local | 

grep “vv AAAE | 

sed 's/[)(,]//g' | 

egrep -v 'rvm|bundle'| 

awk '{print "gem \""$1"\",\""$2"\""}' >>Gemfile 
生成 的 Gemfile 可 以 分 发 到 其 他 需要 相同 环境 的 机 器 上 (比如 其 他 的 开发 机 或 者 独立 部 署 
环境 ) ， 否 则 ， 你 就 需要 安装 Ruby 或 者 RVM， 然 后 再 烦琐 地 手动 安装 gem 进行 设置 。 


10.1.5 Sinatra 


正如 Sinatra 网 站 (http:/www.sinatrarb.com) 上 所 描述 的 ，Sinatra 是 一 个 “用 最 小 成 本 快 
速 创建 基于 Ruby 的 Web 应 用 ”的 DSL。 本 质 上 ， 它 是 一 个 运行 在 Rack (一 个 Ruby Web 
服务 器 和 Web 框架 的 通用 接口 ) 上 使 用 了 Ruby 可 访问 的 接口 的 HTTP 包装 器 。Sinatra 应 
用 由 路 由 (每 个 HTTP 方法 对 应 一 个 URL 匹配 模式 ) 组 成 。 一 个 路 由 关联 一 个 块 ， 可 用 
于 实现 相应 请 求 (通过 执行 Ruby 代码 ， 演 染 一 个 模板 ， 等 等 )。 








默认 条 件 下 ，Sinatra 也 支持 public 目录 下 的 静态 文件 服务 器 (如 图 10-2 所 示 )。 这 使 得 它 
成 为 一 种 理想 的 工具 ， 可 以 创建 一 组 在 HTML、CSS、JavaScript 应 用 后 台 的 基于 Ruby 的 
网 络 API。 它 绝 不 局 限于 这 种 方法 。 一 个 标准 的 服务 器 端 MVC 方法 采用 了 view 目录 (上 默 
认 条 件 下 ) 中 基于 Ruby 的 模板 (ERB ) 。 



























Ruby Sinatramy 
webapp.rb 








站 服务 器 谊 染 (模板 ) 
| views 


静态 内 容 (HTML、CSS、JavaScript) 
public 











图 10-2，Sinatra 的 默认 目录 结构 


Sinatra 非常 小 ， 因 此 有 时 候 被 当 作 一 个 微型 框架 。 和 Ruby 库 中 其 他 的 最 好 框架 一 样 ， 它 
能 把 自己 封装 起 来 ， 只 露出 清晰 的 接口 供 你 引用 。 























es 


或 者 更 准确 地 说 ， 作 为 一 门 领域 专用 语言 (http://martinfowler.com/books/dsl.html) ， 它 提高 
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了 程 





序 员 的 生产 力 和 沟通 效率 ， 因 为 它 和 它 所 代表 的 领域 (HTTP Web 应 用 ) 紧密 结合 。 


Sinatra 适合 于 从 小 应 用 ( 按 经 典 方式 进行 设计 ) 扩展 到 一 种 被 认为 更 适合 于 生产 部 署 ( 模 
块 化 的 编写 风格 ) 的 形式 。 因 此 可 行 的 方法 是 从 一 个 小 的 Sinatra 应 用 开始 ， 然 后 将 其 逐渐 
打造 成 最 终 的 应 用 。 因 为 其 简单 且 透 明 的 特性 ，Sinatra 也 可 用 于 原型 设计 ， 产 出 一 个 基本 
可 以 作为 正式 文档 来 实现 独立 系统 的 应 用 。 























Sinatra 是 一 个 相当 简单 的 框架 ， 有 很 棒 的 在 线 文档 (参见 http:/www.sinatrarb.com/ 
documentation.html 和 http:/www.sinatrarb.com/intro.html)， 并 且 已 经 得 到 广泛 的 关注 ， 其 
至 都 有 专门 为 它 而 写 的 书 (http://oreil.ly/Sinatra-UR)。Sinatra 本 身 就 值得 我 们 学 习 ， 并 且 


它 还 促使 其 他 语言 中 产生 了 很 多 类 似 的 所 


10. 





1.6 ” JSON 处 理 














架 。 


JSON gem 非常 直观 ， 它 能 进行 Ruby 对 象 和 JSON 字符 串 的 相互 转换 。 通 过 JSON 类 型 和 
Ruby 类 型 之 间 的 直观 映射 ，JSON 数据 处 理 变 得 非常 轻松 。 考 虑 如 下 的 IRB 情形 : 


>require 'json' 
=> true 


> 0 = {:A=>[1,2,3], :B=>{:C=>:D}} 
=> {:A=>[1, 2, 3], :B=>{:C=>:D}} 


> 0.CLass 
=> Hash 


> s=JSON.pretty_generate(o) 


=> 。。。 
> puts s 


WA 


s.class 
=> String 


02=JSON.parse(s) 





=> {"A"=>[1, 2, 3], "B"=>{"C"=>"D"}} 


02.class 
=> Hash 
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Ruby 爱好 者 可 能 会 注意 到 这 里 有 一 些微 妙 之 处 (比如 ，Ruby 的 符号 和 字符 串 都 被 转换 成 
了 JSON 字符 串 )。 但 总 体 来 说 ， 这 个 例子 展示 出 使 用 这 个 包 来 解析 和 生成 JSON 字符 串 是 
非常 简单 且 直 观 的 。 





10.2 ”客户 端 : AngularJS 


AngularJS (通常 简称 为 Angular，http://angularjs.org/) 是 Migko Hevery 和 Adam Abrons 于 
2009 年 提出 的 MV* JavaScript 框架 。 直 到 2014 年 ， 一 个 包括 Igor Minér 和 Vojta Jina 在 内 
的 Google 技术 团队 负责 维护 这 个 项 目 。Angular 读 取 其 相关 HTML 结构 中 的 DOM 元 素 ， 
传递 自 定 义 元 素 和 属性 (指令 )， 并 且 将 数据 绑 定 到 页 面 对 应 的 模型 。 


Angular 旨 在 提供 一 套 完整 的 Web 应 用 开发 方案 。 它 利用 了 HTML 的 声明 性 并 对 它 的 行 
为 进行 了 增强 。 这 个 框架 十 分 复杂 ， 以 至 于 需要 一 本 完整 的 书 (http://shop.oreilly.com/ 
product/0636920028055.do) 来 进行 深入 介绍 。 本 书 并 不 会 详细 讲解 这 个 框架 ,但 会 演示 如 
何 快速 开启 并 运行 。 为 了 更 加 有 效 地 使 用 Angular， 我 们 需要 了 解 一 些 相 关 概 念 。 
































10.2.1 模型 

如 果 你 开发 过 服务 器 端 MVC， 那 么 可 能 会 将 模型 看 成 一 个 包含 了 属性 并 与 关系 型 数据 库 
相关 联 的 类 。Java 开发 者 通常 使 用 Hibernate 和 iBatis， 而 Rails 中 的 ActiveRecord 也 可 以 
用 来 实现 相同 功能 。 还 有 一 些 类 似 Backbone 的 JavaScript 框架 ， 它 们 包含 只 能 被 框架 自身 
识别 的 模型 对 象 。 


在 这 方面 ，Angular 是 完全 不 同 的 。 不 像 其 他 的 JavaScript 框架 那样 有 特殊 的 模型 对 象 ， 
Angular 模型 是 个 简单 的 JavaScript 对 象 。Angular 中 的 模型 仅仅 是 数据 。 因 为 人 们 很 少 关 
注 Angular 中 的 模型 ， 正 如 Angular 常见 问题 (https://docs.angularjs.org/misc/faq) 中 所 提 到 
的 ， 一 些 人 更 多 地 将 它 视 为 一 种 模板 解决 方案 。 然 而 ， 框 架 的 其 他 特性 ， 包 括 双向 数据 绑 
定 ， 令 Angular 不 仅仅 是 一 个 模板 系统 。 


























10.2.2 视图 
视图 是 模型 通过 HTML 模板 的 展现 。 当 模型 发 生变 化 时 ，Angular 的 双向 数据 绑 定 处 于 激 
活 状态 ， 以 便 这 染 视 图 中 需要 更 新 的 部 分 。 表 达 式 是 被 花 括号 包围 的 类 似 JavaScript 的 代 
码 片 段 ， 例 如 {{ _expression_ }}。 


























我 们 可 以 通过 指令 可 以 有 效 地 扩展 HTML 的 功能 。 在 DOM 编译 过 程 中 ， 指 令 会 执行 并 完 
成 各 种 任务 ， 包 括 DOM 操作 〈 如 显示 或 隐藏 元 素 、 循 环 和 创建 新 的 元 素 ， 等 等 ) 以 及 其 
他 任务 。Angular 自 带 一 系列 指令 ， 程 序 员 也 可 以 添加 额外 的 指令 来 实现 类 似 独 立 Web 组 
件 的 服务 。 
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在 JavaScript 中 ， 普 遍 存在 的 问题 之 一 就 是 全 局 变量 。Angular 减轻 了 对 全 局 命名 空间 的 污 
染 。Scope 允许 模板 、 对 象 和 控制 器 共同 工作 。 它 们 被 姐 套 在 DOM 结构 对 应 的 分 层 结构 
中 。Scope 会 检测 模型 的 变化 并 为 表达 式 提 供 执行 上 下 文 。 


10.2.3 控制 器 
控制 器 负责 构建 模型 并 将 它 发 布 到 视图 。 控 制 器 的 相关 代码 包含 在 一 个 JavaScript 函数 中 ， 
ngController 会 将 控制 器 函数 与 视图 绑 定 。 





























Angular Seed 项 目 (https://github.com/angular/angular-seed) 提供 了 一 个 关于 请 求 是 如 何 被 
路 由 到 不 同 控制 器 的 例子 。$routeProvider 服务 通过 一 个 函数 将 URL hash 之 后 的 部 分 和 
对 应 的 模板 、 控 制 器 进行 关联 。 


10.2.4 服务 
Angular 中 存在 各 式 各 样 的 服务 。$parse 服务 解析 表达 式 。 所 有 Angular 应 用 中 的 injector 
都 会 用 于 定位 服务 。 指 令 也 是 如 此 ， 开 发 者 可 以 封装 自己 的 逻辑 来 实现 个 性 化 服务 。 


10.3 比较 jQuery 和 Angular 


人 们 会 很 自然 地 将 jQuery 和 Angular 进行 比较 。 两 者 的 流行 程度 及 影响 程度 都 很 高 。 
jQuery 显然 是 公认 的 业界 领袖 ， 而 Angular 却 能 够 解决 一 些 在 单独 使 用 jQuery 时 会 遇 到 的 
问题 。 粗 略 地 看 下 Angular 文档 ， 我 们 会 发 现 Angular 兼容 jQuery， 并且 有 些 网 站 会 发 布 
同时 使 用 Angular 和 jQuery 的 例子 。 虽 然 它 们 都 可 以 用 来 快速 开发 大 型 Web 应 用 ， 但 是 
还 有 许多 会 影响 到 设计 和 开发 的 领域 值得 思考 。 


10.3.1 DOM 和 模型 操作 


一 个 项 目 可 以 同时 使 用 jQuery 和 Angular。 如 果 没 有 用 到 jQuery，Angular 会 使 用 内 置 的 
jQuery 子 集 。 在 这 个 层面 上 ， 它 们 是 兼容 的 ， 并 且 都 支持 DOM 操作 。 


然而 ， 两 种 框架 都 可 以 考虑 时 ， 应 该 优先 考虑 使 用 Angular。 这 是 因为 每 种 框架 在 维护 应 
用 状态 时 都 有 本 质 上 的 区 别 。jQuery 应 用 通过 直接 操作 DOM 和 控制 视图 的 方式 控制 应 
用 状态 。Angular 应 用 却 是 将 模型 作为 “真正 的 产 “， 而 不 是 DOM。 框 架 会 直接 操作 模 
型 ， 而 不 是 操作 DOM。 模 型 的 改变 会 直接 导致 DOM 的 改变 。 如 果 在 Angular 应 用 中 依赖 
jQuery 的 DOM 操作 会 导致 一 些 难以 发 现 的 小 问题 ， 因 为 Angular 的 模型 无 法 同步 并 且 不 
知道 通过 jQuery 做 了 哪些 更 改 。 




































































由 于 方法 上 的 根本 性 差异 ， 我 们 很 难 将 Angular 整合 到 一 个 已 存在 的 基于 jQuery 的 应 用 
中 。Angular 的 DOM 操作 需要 通过 Angular 指令 来 完成 。 将 jQuery 应 用 的 功能 转化 为 指 
令 也 很 具 挑战 性 ， 如 果 从 最 开始 就 使 用 Angular 编写 应 用 ， 一 切 都 会 简单 得 多 。 
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10.3.2 Angular 的 不 可 见 性 
大 家 对 Angular 是 否 符合 JavaScript 在 HTML 中 的 不 可 见 原则 有 着 不 同意 见 ， 但 是 在 MV* 
框架 中 需要 一 个 共同 点 将 表现 和 行为 进行 连接 。 我 们 可 以 通过 如 下 示例 考虑 这 个 问题 。 














将 JavaScript 代码 放 在 HTML 中 会 被 认为 是 不 合适 的 行为 : 





<button oncLick='someFunction() >CLick Me</button> 


在 jQuery 中 ，HTML 元 素 通过 CSS 选择 器 来 定位 ， 通 过 ID 来 选择 一 个 元 素 是 通用 做 法 : 








<button id='myButton'>Click Me</button> 











通过 jQuery 元 素 选择 器 的 事件 处 理 程 序 对 选择 的 元 素 进 行事 件 绑 定 ， 以 建立 起 HTML 和 
JavaScript 的 连接 : 


$("#myButton").on('click', function(){someFunction();}); 





Angular 通过 使 用 指令 (HTML 的 自 定义 属性 ) 来 实现 这 种 连接 : 





<button ng-click="someFunction()">Click Me</button> 





这 并 不 违背 JavaScript 在 HTML 中 不 可 见 的 目标 。Angular 的 属性 具有 明显 优势 : 它们 其 
有 简单 且 易 理解 的 含义 。 而 jQuery 选择 器 需要 使 用 任意 的 HTML 属性 (ID 和 类 )。 使 用 
这 些 标 准 属性 会 引起 歧义 ， 我 们 不 清楚 这 些 值 是 否 会 影响 表现 或 行为 ， 甚 至 两 者 都 影响 。 


HIML5 引入 了 data 属性 ， 从 而 使 这 个 问题 得 到 适当 缓解 。 





























HTML data 属性 
HTML 的 data 属性 是 指 以 “data-” 开 头 且 不 会 影响 布局 和 展现 的 属性 。 这 类 属性 专门 
用 于 存储 数据 。 多 数 属 性 是 通过 属性 名 中 “data-” 之 后 的 字符 来 区 分 的 。 
<LL class="pet" data-name="Katniss" data-type="Civet" > 


Hi Kat 
</li> 











10.4 项 目 


学 习 JavaScript 框架 有 两 种 简单 的 方式 。 你 可 以 从 一 个 最 小 的 可 用 项 目 开 始 ， 然 后 逐步 对 
它 进 行 扩展 ， 你 也 可 以 从 一 个 功能 全 面 的 引导 项 目 开始 ， 然 后 去 填充 组 成 项 目的 大 量 空 文 
件 。 这 两 种 方式 在 某 些 情形 下 都 是 有 效 且 适用 的 。 

最 小 可 用 示例 更 易于 排除 错误 和 交流 问题 (特别 是 在 类 似 JSFiddle 网 站 http://jsfiddle.net/ 
上 的 示例 )， 而 引导 项 目 则 会 为 全 规模 项 目的 后 续 开 发 提供 稳定 的 基础 。 下 面 就 是 一 个 从 
最 小 可 用 项 目 开 始 ， 逐 步 增加 功能 的 示例 。 
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应 用 基于 JRuby 1.7.4、Sinatra 和 JSON gem 运行 。 在 每 一 页 中 都 迭代 增加 额外 功能 。 


想 要 运行 这 个 项 目 ， 先 下 载 源码 (https://github.com/java-javascript/client-server-web-apps/ 
tree/master/Chapter-10-JRuby-and-Angular/rvm-jruby-sinatra-REST) ， 安 装 RVM 和 任意 版 本 
的 了 Ruby， 然 后 安装 依赖 的 gem， 再 运行 服务 器 : 





$ rvm list 
rvm rubies 


jruby-1.7.4 [ x86_64 ] 
=* ruby-1.9.3-p194 [ x86 64 ] 
ruby-2.0.0-p247 [ x86_64 ] 


# => - current 
# =* - current && default 
#4 * - default 


$ls 
README .md pubLic webapp.rb 


$ ruby webapp.rb 

[2013-08-13 21:20:01] INFO WEBrick 1.3.1 

[2013-08-13 21:20:01] INFO ruby 1.9.3 (2013-05-16) [java] 

== Sinatra/1.4.3 has taken the stage on 4567 for development... 
[2013-08-13 21:20:01] INFO WEBrick::HTTPServer#start: pid=71632 port=4567 





Web 应 用 的 根 目录 是 基于 HTML 文件 的 一 系列 公共 目录 的 链接 列表 。 虽 然 有 点 卖弄 的 嫌 
疑 ， 但 这 其 实 是 一 个 展现 Ruby 简洁 性 和 表现 力 的 有 趣 示例 。 下 面 代码 中 webapp.rb 定义 
的 API 是 关于 其 用 途 的 描述 。 














get '/' do 
Dir.entries('public').entries.map{|f| 
"<a href='#{f}'>#{f}</a><br/>" if f=~/.*\.html/ 
}.join 
end 


通常 情况 下 ，HTML 文件 生成 于 服务 器 端 ， 并 且 由 单独 的 模板 文件 泻 染 而 成 ;， 或 者 返回 
JSON、XML 或 其 他 格式 的 数据 。Sinatra 本 质 上 是 一 个 HTML DSL， 对 于 返回 值 的 类 型 没 
有 特殊 限制 。 图 10-3 显示 了 Web 应 用 的 目录 ， 其 中 链接 指向 Angular 示例 。 






































€ CC | [ localhost:4567 





angularl html 
angular2 .html 
angular2 5.html 
angular3.html 
angular4.html 
angular5 .html 











10-3: Web 应 用 的 链接 
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第 一 个 示例 (如 图 10-4 所 示 ) 简单 地 显示 了 2 个 文本 框 。 如 果 改 变 其 中 一 个 文本 框 中 的 文 
本 ， 相 应 的 文本 也 会 显示 在 另 一 个 文本 框 中 。 














所 CC | [9 localhost:4567/angularl.html 
Hello World 
Hello world| J 








10-4: Web 应 用 的 文本 框 


Angular JavaScript 文件 (script 标签 之 后 的 内 容 ) 的 压缩 版 本 可 以 在 Google 的 公共 库 
(https://developers.google.com/speed/libraries/) 下 载 。JavaScript 文件 加 载 完成 后 ， 会 遍历 
DOM 以 寻找 Angular 指令 (HTML 自 定义 属性 )。 框 架 会 识别 出 ng-app 指令 ， 并 将 它 作为 
整个 应 用 的 外 边界 。ng-model 指令 用 来 识别 模型 ， 比 如 改变 一 个 文本 框 的 值 ， 另 一 个 由 于 
内 置 的 双向 数据 绑 定 也 会 改变 。 


下 一 





























<!DOCTYPE htmL> 
<htmL ng-app> 
<head> 
<meta http-equiv="Content-type" content="text/html; charset=utf-8"> 
<title>angulari</title> 
<script src="http://ajax.googleapis.com/ajax/libs/angularjs/1.0.3/angular.min.js"> 
</script> 
</head> 
<body> 
<input type="text" ng-model="myModel" value="{{myModel}}" /> 
<br /> 
<input type="text" ng-model="myModel" value="{{myModel}}" /> 
</body> 
</htmL> 


个 示例 将 演示 如 何 调 用 外 部 服务 〈 在 本 例 中 是 谷歌 财经 ， 即 Google Finance) 和 展示 


返回 的 JSON 对 象 ， 如 图 10-5 所 示 。Google Finance API 已 经 被 废弃 (http:/googlecode. 
blogspot.com/2011/05/spring-cleaning-for-some-of-our-apis.html) ， 但 是 具体 的 关闭 时 间 还 不 
确定 。 这 个 初始 示例 不 太 漂 亮 ， 功 能 也 不 太 完 整 ， 但 是 只 要 少量 的 Angular 功能 就 可 以 完 
成 全 部 工作 。 








€ CC | [0 localhost:4567/angular2.html ge 





AAPL 
{"id":"22144", "t":"AAPL", "e":"NASDAQ", "1]":"489.57","] cur":"489.57" 


| Lookup 








10-5; 苹果 电脑 中 的 Google 财经 数据 
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综合 实例 中 突 元 的 JavaScript 代码 
在 这 些 例子 中 ，JavaScript 代码 包含 在 行内 ， 在 一 处 就 能 看 到 全 部 逻辑 。 根 据 不 可 见 
原则 的 规定 ， 这 样 的 代码 应 该 是 要 分 离 的 。 此 外 ， 理 想 情况 下 Angular 控制 器 也 应 该 
是 轻 量 的 ， 复 杂 的 逻辑 应 该 提取 到 Angular 服务 中 。 书 中 提 到 的 这 些 例子 都 是 用 于 帮 
助理 解 的 单个 文件 ， 这 种 突 元 是 由 于 解释 和 说 明 需 要 造成 的 ， 在 实际 项 目 中 则 会 更 加 
优雅 。 











在 前 一 个 例子 中 ，ng-app 指令 单独 放置 。 在 这 个 例子 中 ，angular 模型 被 特意 命名 为 app 
(在 HTML 元 素 上 ng-app 属性 的 值 ) 。Angular 源 文件 被 分 离 成 几 个 不 同 的 JavaScript 文件 
用 于 按 需 加 载 。Angular 库 资 源 在 Angular 基础 文件 之 后 立即 被 加 载 ， 同 时 包括 ngResource 
模块 。 这 个 模块 允许 REST 式 服务 而 不 是 调用 低级 的 $http 服务 。 我 们 创建 的 app 模型 是 
基于 ngResource 模块 的 。 














在 本 例 和 上 例 中 ，ng-model 被 映射 到 一 个 JavaScript 变量 。 这 里 的 ng-controller 指令 对 
应 一 个 被 称 为 AppCtrl 的 JavaScript 函数 。 虽 然 所 有 的 Angular 控制 器 都 是 JavaScript 函 
数 ， 但 反之 就 是 错 的 。Llookup() 函数 被 包含 在 controller 函数 的 执行 上 下 文中 (或 者 说 
$scope)。 正 如 ng-click 指令 所 定义 的 那样 ， 按 钮 无 论 何 时 被 点 击 都 会 调用 对 应 的 函数 。 
Lookup 函数 会 调用 定义 在 ngResource 模块 中 的 $resource 服务 ， 参 数 会 被 传递 给 Google 
Finance API 对 应 的 服务 。HTTP GET 请 求 使 用 JSONP (因为 所 请 求 的 服务 是 跨 域 的 )， 得 
到 一 个 返回 的 数组 。 返 回 的 数组 值 被 写 入 $scope.result， 其 中 第 一 个 记录 会 以 原始 形式 
展现 在 前 一 个 元 素 中 。 双 花 括 号 中 的 Angular 表达 式 会 被 $parse 服务 处 理 并 绑 定 。 









































<!DOCTYPE htmL> 


<htmL ng-app="app"> 
<head> 
<meta http-equiv="Content-type" content="text/html; charset=utf-8" > 
<title>angular2</title> 
<script src= 
"http://ajax.googleapis.com/ajax/\libs/angularjs/1.0.3/angular .min.js"> 
</script> 
<script src= 
"http://ajax.googleapis.com/ajax/libs/angularjs/1.0.3/angular-resource.min.js"> 
</script> 
<script> 
angular .module('app', ['ngResource']); 


function AppCtrl($scope, S$Sresource) { 
$scope. lookup = function(){ 


$scope.result = S$resource( 
'https://finance.google.com/finance/info', 


client:'ig', 





CaLLback: 'JSON_CALLBACK' 


]， 
{ 
get: { 
method: 'JSONP ' ， 
params:{q: $scope.stockSymbol}, 
isArray: true 
} 
} 
) .get(); 
} 
} 
</script> 
</head> 
<body> 
<div ng-controller="AppCtrl"> 
<input type="text" ng-model="stockSymbol" /> 
<pre>{{result[0]}}</pre> 
<button ng-cLick='Lookup() '>Lookup</button> 
</div> 
</body> 
</htmL> 


可 以 将 原始 数据 格式 化 之 后 进行 展示 。 例 如 ， 可 以 使 用 以 下 方式 展示 实时 价格 : 
{{result[0].l_cur}} 


受 篇 幅 限制 ， 此 处 就 不 贴 出 所 有 代码 了 ， 完 整 的 代码 可 以 参考 GitHub (https://github.com/ 
Java-javascript/client-server-web-apps/tree/master/Chapter-10-JRuby-and-Angular/rvm-jruby- 
sinatra-REST) 。 


如 图 10-6 所 示 的 angular3.html 增加 了 一 个 功能 ， 从 而 可 以 将 股票 添加 到 以 表格 形式 显示 
的 “投资 组 合 ” 中 。 我 们 可 以 通过 一 个 输入 文本 框 来 过 小 数据 ， 还 可 以 通过 点 击 列 头 来 对 
其 进行 排序 。 表 格 中 的 记录 也 可 以 被 删除 。 遗 憾 的 是 ， 没 有 地 方 可 以 保存 数据 ， 所 以 页 面 
刷新 之 后 所 有 之 前 添加 的 记录 都 会 丢失 。 











扣 GC 口 localhost:4567/angular3.html x 三 
ORCL Lookup |Oracle Corporation 33.25 
(Filter) 


| Add to Portfolio 
Symbol Description Price 52 Week Low 52 Week High 


AAPL Apple Inc. 489.57 385.10 705.07 [x 
GOOG Google Inc 881.25 636.00 928.00 [x 
ORCL Oracle Corporation 33.25 29.52 36.43 [x 











图 10-6: 投资 组 合 列表 
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示例 angular4.html 通过 引入 集成 服务 器 端 弥补 了 之 前 的 缺陷 。 数 据 被 存储 到 内 存 中 ， 
除非 服务 器 重启 ， 否 则 数据 会 一 直 存 在 。webapp.rb 是 一 个 使 用 Sinatra 微型 框架 构建 
的 Ruby 应 用 ， 前 两 行 代 码 用 来 引入 相关 的 Ruby 和 Java 资源 。 严 格 来 说 ，Java 可 以 
完全 省 略 ， 应 用 可 以 运行 在 基于 C 的 Ruby 组 件 之 上 。 这 里 引入 Java 仅仅 是 用 来 演 
示 Java 是 怎么 被 引用 的 。 如 图 10-7 所 示 ，/version 的 GET 请 求 中 包含 了 一 个 System. 
currentTimeMillis() 的 请 求 。 


























全 CC [9 localhost:4567/version 





(Ruby Platform: java Ruby Version: 1.9.3) Call From Java: 1376443909894 











10-7: 页 面 显 示 Java 和 Ruby 都 可 用 且 能 运行 


一 个 类 变量 ($stocks) 被 定义 成 数组 形式 ， 用 来 记录 股票 的 投资 组 合 。HTTP PUT、 
DELETE 和 GET 请 求 用 来 实现 对 于 单独 股票 记录 的 CRUD 操作 ， 而 /stocks GET 链接 则 会 
返回 股票 列表 信息 。 














%w{rubygems sinatra java json}.each{|r|require r} 
java_import 'java.lang.System' 


$stocks = [] 


get '/' do 
Dir.entries('public').entries.map{|f| 
"<a href='#{f}'>#{f}</a><br/>" if f=~/.*\.html/ 
}.join 
end 


get '/version' do 

"(Ruby Platform: #{RUBY_PLATFORM} "+ 

"Ruby Version: #{RUBY_VERSION}) " + 

"Call From Java: #{System.currentTimeMillis()}" 
end 


get '/stocks' do 
$stocks.to_json 
end 


get '/stock/:t' do 
stock = $stocks.find{|ele['t']==params['t']} 
if stock.nil? 
status 404 
else 
status 200 
body(stock.to_json) 
end 
end 





delete '/stock/:t' do 


stock = $stocks.find{lele['t']==params['t']} 
if stock.nil? 
status 404 
else 
$stocks.delete(stock) 
status 202 
body(stock.to_json) 
end 
end 


put '/stock/:t' do 
0 = JSON.parse(request.body.read)['data'] 
puts "---\n #{0o['name']} \n---\n" 
$stocks << 0 
status 200 
end 


示例 angular5.html 是 我 们 第 一 次 添加 样式 。 如 图 10-8 所 示 ， 这 个 示例 引入 了 Twitter 
Bootstrap CSS， 其 中 添加 了 一 些 样式 以 及 符合 Bootstrap 规范 的 HTML 元 素 。 











€ CC 癌 localhost:4567/angular5.html 
Lookup 
(Filter) 
Add to Portfolio | 
Symbol Description Price 52 Week Low 52 Week High 
AAPL Apple Inc. 489.57 385.10 705.07| x 
GOOG Google Inc 881.25 636.00 928.00 x 
ORCL Oracle Corporation 33.25 29.52 36.43| x 

















图 10-8: 添加 样式 后 的 投资 组 合 


重 构 这 个 项 目 ,将 HTML 中 的 CSS 和 JavaScript 提取 到 外 部 文件 中 会 很 有 意义 ， 整 个 项 目 
可 能 会 被 改造 成 面向 目标 用 户 和 开发 者 工具 的 引导 项 目 。 


10.5 ”小结 


相 比 其 他 流行 库 ，Angular 和 Sinatra 只 需要 更 少 的 代码 就 能 构建 出 高 度 动态 的 应 用 。 它 
们 值得 研究 不 仅仅 是 因为 它们 自身 的 价值 ， 更 在 于 它们 对 其 他 技术 产生 的 持续 影响 力 。 
Sinatra 启发 了 很 多 其 他 HTTP DSL。Angular 提前 使 用 了 一 些 类 似 HTML5 Web 组 件 的 技 
术 ， 比 如 模板 声明 和 双向 绑 定 。 它 们 既是 可 用 于 当前 项 目的 成 熟 技术 ， 同 时 也 预示 着 Web 
开发 的 未 来 趋势 。 
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第 11 章 


打包 和 部 著 





“那天 我 在 码头 等 人 时 ,脑袋 里 突然 跳出 一 个 想法 : 不 挪动 车 里 的 货物 ， 而 是 连 
拖车 一 起 吊 放 到 船上 ， 这 样 岂 不 是 简单 很 多 ? ” 
一 一 马尔 科 姆 。 麦克 林 


马尔 科 姆 .麦克 林 在 1937 年 的 一 个 想法 ， 让 他 后 来 成 为 了 传奇 的 “集装箱 化 之 父 "， 当 时 
他 正在 霍 博 肯 码 头等 待 将 自己 的 一 包 包 棉花 运往 海外 。1956 年 ， 麦 殉 林 发 明了 金属 运输 集 
装 箱 ， 极 大 地 简化 了 货物 装卸 ， 为 航运 业 带 来 了 一 场 革命 。 打 包 方 式 的 创新 提高 了 装运 的 
效率 。 在 科技 领域 ， 部 署 和 发 布 应 用 犹如 装运 。Java 提供 了 标准 的 打包 方式 ， 这 是 发 布 代 
码 、 部 署 应 用 的 基础 。 


11.1 打包 Java 和 JEE 应 用 


Java 的 打包 格式 是 JEE 应 用 的 基础 构建 模块 ， 而 且 还 被 用 在 近来 出 现 的 、 没 有 严格 遵守 
JEE 规范 的 部 署 流程 里 。 














最 初 ，Java 开发 者 在 部 署 包 之 外 编写 代码 。 一 个 Java 类 对 应 操作 系统 中 的 一 个 文件 。 让 人 
感到 迷惑 的 是 ，Java 的 包 和 打包 方式 无 关 ， 而 是 一 个 反映 了 从 应 用 的 根 目 录 到 类 所 在 目录 
的 命名 空间 。 在 程序 员 的 开发 环境 之 外 ， 很 少 能 看 到 类 和 包 。 应 用 或 模块 在 部 署 到 生产 环 
噶 或 最 终 用 户 之 前 ， 需 要 压缩 并 打包 成 一 个 单元 。 


Java 归档 (JAR) 文件 用 来 将 Java 类 和 资源 文件 打包 成 单个 归档 文件 。JAR 文件 使 用 ZIP 
格式 压缩 ， 并 包含 一 个 路 径 名 为 META-INF/MANIFEST.MF 的 Manifest 资源 配置 文件 。 可 
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以 使 用 JDK 提供 的 jar 实用 工具 (http://docs.oracle.com/javase/7/docs/technotes/tools/solaris/ 
jar.html) 来 生成 JAR 文件 。 简 单 来 说 ，JAR 文件 就 是 一 个 .zip 文件 ， 只 不 过 在 META- 
INF 目录 下 包含 了 一 些 额外 的 描述 信息 。 











JAR 并 不 专属 于 JEE， 它 是 标准 JDK 的 一 部 分 ， 其 规范 (http://docs.oracle.com/javase/7/ 
docs/technotes/guides/jar/jar.html#JAR Manifest) 可 以 在 JDK 文档 中 找到 。JEE 描述 了 JAR 
文件 的 几 种 使 用 方式 。JEE 应 用 客户 端 模块 和 EJB 模块 被 打包 成 JAR 文件 。JEE 的 其 他 打 
包 格 式 也 基于 JAR。 根 据 功能 和 内 容 的 不 同 ，JEE 其 他 归档 文件 其 实 也 是 JAR 文件 ， 只 是 
文件 名 后 组 不 同 而 已 。 我 们 可 以 手工 创建 JEE 归档 文件 ， 但 这 并 不 常见 ， 通 常 是 使 用 诸如 
Ant、Maven 或 者 Gradle 这 样 的 构建 工具 。 



































Web 模块 是 JEE 中 最 小 的 部 署 单元 ， 该 模块 包含 Web 组 件 和 资源 文件 ， 主 要 是 静态 内 容 。 
Web 模块 可 以 被 打包 成 一 个 Web 归档 文件 ， 或 称 为 WAR。WAR 文件 有 一 个 /WEB-INF 目 
录 ， 该 目录 下 有 一 个 名 为 web.xml 的 文件 ， 它 定义 了 Web 应 用 的 结构 和 对 归档 文件 中 其 他 资 
源 的 引用 。WAR 格式 极其 灵活 ， 可 以 被 部 署 到 只 支持 很 小 一 部 分 JEE 规范 的 Web 容器 中 。 
































常用 的 Web 容器 有 Tomcat (http://tomcat.apache.org/) 和 Jetty (http://www.eclipse.org/ 
jetty/) 。Web 容器 的 开发 早 于 JEE 规范 里 对 各 种 技术 的 定义 ， 因 此 每 个 容器 都 有 各 自 不 
同 的 特性 。 














企业 归档 文件 ， 或 称 为 EAR 文件 ， 包含 了 WAR、JAR 和 一 个 application.xml 文件 ， 该 
文件 引用 了 包含 的 模块 ， 定 义 了 安全 角色 。 就 像 它 的 名 字 一 样 ，EAR 为 企业 级 应 用 而 生 ， 
必须 部 署 在 应 用 服务 器 中 。 和 Web 容器 相 比 ， 应 用 服务 器 支持 更 多 的 JEE 规范 。EAR 
文件 不 能 在 Web 容器 里 运行 ， 它 们 需要 EJB 支持 和 一 些 其 他 服务 。 应 用 服务 器 有 JBoss 
(http://jbossas.jboss.org/)、IBM 的 WebSphere (http://www-01.ibm.com/software/websphere/) 
和 Oracle 的 WebLogic Server (http://www.oracle.com/us/products/middleware/cloud-app- 




















foundation/weblogic/overview/index.htm!l) 和 


为 了 描述 的 完整 性 ， 还 得 提 一 下 另 一 种 不 太 和 常见 的 JEE 归档 文件 : 资源 适配器 模块 
(RAR)。RAR 用 来 连接 企业 信息 系统 (Enterprise Information System，EIS)。 企 业 信息 系 
统 通常 指 遗 留 系统 ， 比 如 ERP、 主 机 、 队 列 或 其 他 服务 。RAR 和 JDBC 驱动 类 似 ， 为 后 台 
系统 提供 统一 接口 ， 但 和 JDBC 不 同 的 是 ， 它 不 局 限于 连接 关系 型 数据 库 。 表 11-1 列举 了 
相关 的 文件 后 级 。 


表 11-1: Java 打 包 格 式 















































后 缀 名 称 描述 

jar Java 归档 文件 标准 Java 打包 格式 

.War Web 归档 文件 映射 至 唯一 的 Web 根 路 径 
.ea 企业 级 应 用 归档 文件 ”包含 若干 个 WAR 和 JAR 
Tar 资源 适配器 模块 和 企业 信息 系统 通信 
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Web 应 用 开发 者 对 WAR 尤其 感 兴趣 ， 甚 他 语言 的 框架 也 纷纷 采用 这 种 格式 ， 由 此 可 见 一 
斑 。Play 框架 创建 的 WAR 包含 Scala 资源 ，Ruby 有 一 个 名 为 Warbler (http://caldersphere. 
rubyforge.org/warbler/) 的 gem， 专 门 用 于 将 Ruby 应 用 打包 成 JAR 或 WAR 文件 。 














现 有 的 Java 和 JEE 打包 方式 已 经 能 够 很 好 地 用 于 开发 客户 端 一 服务 器 端的 Web 应 用 。 开 
发 稍 具 规 模 的 项 目 时 ， 如 何 将 服务 器 端 和 客户 端的 代码 分 离 到 各 自 的 归档 文件 中 是 我 们 需 
要 考虑 的 。 一 个 应 用 可 以 被 部 署 为 一 个 EAR， 其 中 包含 提供 API 代码 的 服务 器 端的 WAR 
包 ， 以 及 包含 HIML、CSS 和 JavaScript 的 独立 的 客户 端 WAR 包 。 这 两 个 WAR 包 也 可 
以 脱离 EAR， 分 别 部 署 到 两 个 Web 容器 中 。 和 我 们 目前 讲 到 的 其 他 领域 不 同 ， 打 包 方 式 
一 直 没 有 什么 重大 创新 。 
































WAR 包 示 例 


可 以 使 用 Maven 构建 本 章 所 附 代码 (https://github.com/java-javascript/client-server-web- 
apps/tree/master/Chapter-11-Packaging-and-Deployment/jersey-jquery-REST) 从 而 生成 随 
后 插图 中 使 用 的 WAR 包 。 该 WAR 包 和 包含 了 客户 茹 和 服务 器 问 的 代码 ， 只 做 最 简单 
的 展示 之 用 。 











归档 文件 作为 一 个 打包 了 相关 Java 资源 的 独立 包 ， 在 分 离 依 赖 方面 做 得 并 不 好 。 归 档 文 件 
(假设 是 自 包 含 的 ) 需要 部 署 到 一 个 运行 环境 中 执行 。 尽 管 打包 方式 一 直 以 来 变化 不 大 ， 
但 部 署 方式 却 改 变 了 很 多 。 


11.2 JEE 应 用 的 部 署 


过 去 ， 部 署 方式 十 分 有 限 ， 各 种 方式 的 区 别 主 要 在 于 自动 化 程度 。 部 署 应 用 时 ， 总 是 假定 
已 经 有 程序 员 或 系统 管理 员 安 装 并 配置 好 了 应 用 服务 器 。 直 到 今天 ，JEE 规范 本 身 仍 是 朝 
着 这 个 方向 ， 从 其 对 参与 部 署 应 用 的 角色 描述 上 就 可 见 一 斑 。JEE Web 应 用 的 部 署 方式 如 
图 11-1 所 示 。 


























Web 应 用 


应 用 服务 器 














11-1: JEE Web 应 用 的 部 署 
JEE 中 的 角色 描述 了 参与 开发 流程 的 人 的 分 工 ， 包 括 部 署 者 和 系统 管理 员 。 部 署 者 负责 在 
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运行 环境 中 配置 应 用 、 验 证 模块 是 否 遵循 JEE 规范 ， 以 及 在 一 台 或 多 台 服 务 器 上 安装 应 用 
模块 。 从 描述 上 可 知 ， 人 们 希望 已 经 有 人 或 组 织 在 JEE 应 用 的 目标 环境 中 安装 好 了 应 用 
服务 器 。( 和 大 规模 部 署 中 持续 交付 的 通用 做 法 不 同 ， 它 强调 了 部 署 时 的 人 工 干 预 ， 关 于 
“持续 交付 ”， 请 参见 http://en.wikipedia.org/wiki/Continuous_delivery) 就 像 前 面 说 的 ， 这 并 
不 是 部 署 Java Web 应 用 的 唯一 方式 ， 但 却 是 唯一 遵循 规范 的 方式 。 
































JEE 和 云 部 署 
和 其 他 巨大 的 投入 一 样 ，JEE 也 力求 和 以 前 版 本 保持 连续 。 同 时 ， 它 也 在 试图 徐 盖 一 
系列 部 署 环境 。 有 些 情况 下 ， 这 是 它 的 优势， 有 时 却 成 为 了 缺点 。 最 近 一 次 JEE 版 本 
的 更 新 又 增加 了 云 部 署 方式 ， 虽 然 部 署 者 的 职责 看 似 被 削减 到 最 少 ， 但 在 实践 中 ， 部 
署 者 也 常常 是 系统 管理 员 。 
以 云 部 署 为 例 ， 部 署 者 负责 配置 应 用 ， 让 其 在 云 环 境 中 运行 。 部 署 者 在 云 环 
境 中 安装 应 用 、 配 置 其 外 部 依赖 ， 可 能 还 要 准备 需要 的 资源 。 


在 云 环境 下 ， 系 统管 理 员 负责 安装 、 配 置 、 管 理 和 维护 云 环境 ， 包 括 供应 用 
在 环境 中 运行 使 用 的 资源 。 


一 一 JEE7 (http:/download.oracle.com/otndocs/jcp/ 


java_ee-7-fr-eval-spec/index.html ) 














若 要 遵循 JEE 规范 ， 事 先 安装 好 应 用 服务 器 ， 只 有 有 限 的 几 种 部 署 方式 ， 但 这 并 不 代表 全 
部 的 部 署 实践 。 可 以 在 待 部 署 的 服务 器 上 构建 项 目 ， 这 要 求 所 有 相关 服务 器 上 都 安装 有 构 
建 工具 ， 但 会 导致 系统 性 能 下 降 或 中 断 服务 器 上 的 服务 。 如 果 在 生产 服务 器 上 安装 额外 的 
软件 或 者 部 署 未 经 测试 的 代码 ， 则 会 带 来 六 在 的 安全 漏洞 。 这 些 问 题 都 意味 着 最 好 不 要 在 
生产 服务 器 上 构建 项 目 ， 而 是 将 打包 好 的 应 用 分 发 给 生产 服务 器 来 进行 部 署 。 














随 着 在 大 量 服务 器 上 部 署 的 现代 部 署 方式 的 出 现 ， 在 部 署 服务 器 上 构建 项 目的 情况 越 来 越 
少 。 极端 情 况 下 ， 这 可 能 有 用 ,但 总 体 上 来 说 ， 最 好 在 一 个 非 生产 机 器 上 构建 ， 然 后 将 结 
果 分 发 给 目标 服务 器 进行 安装 。 即 使 在 项 目 早期 不 必 如 此 ， 但 它 提 供 了 很 大 的 灵活 性 ， 如 
果 应 用 的 访问 量 逐 渐 增 长 ， 就 有 必要 增加 新 的 服务 器 了 。 近 些 年 ， 很 多 分 布 式 远程 执行 
Shell 命令 的 项 目 被 开发 出 来 ， 让 这 种 部 署 方式 变 得 更 容易 管理 。 











11.2.1 图 形 界 面 管理 

用 户 可 以 通过 与 图 形 界 面 交 互 来 管理 应 用 服务 器 ， 虽 然 并 不 是 所 有 的 Web 容器 都 提供 了 这 
种 管理 方式 。 在 很 久 以 前 ， 很 多 图 形 界 面 还 是 那 种 老式 的 、 本 地 原生 应 用 ， 通 过 网 络 远程 
连接 至 应 用 服务 器 。 现 在 ，GUI 都 是 单独 的 Web 应 用 。 应 用 安装 好 后 ， 需 要 进行 额外 配 
置 。 需 要 防止 管理 门户 被 公开 ， 这 可 能 会 造成 一 个 安全 漏洞 ， 需 要 调整 管理 服务 器 的 根 目 
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录 ， 避 免 和 其 他 部 署 其 中 的 Web 应 用 冲突 。 这 些 配 置 方面 的 考虑 让 很 多 管理 员 在 初始 安装 
过 程 中 直接 禁用 管理 Web 应 用 。 











红 帽 公司 发 布 的 JBoss 企业 应 用 平台 6 (JBoss Enterprise Application Platform 6，JBoss EAP 6) 就 
自 带 一 个 基于 Web 的 图 形 管理 界面 ， 如 图 11-2 所 示 。 下 载 (http://jbossas.jboss.org/downloads) 
并 添加 一 个 管理 账户 后 ， 启 动 服务 器 ， 默 认 显示 管理 界面 。 点 儿 个 按钮 ， 管 理 员 就 能 部 署 
和 激活 一 个 WAR。 这 样 一 个 Web 应 用 就 部 署 成 功 了 ， 根 目录 也 指定 好 了 。 




























JBOSS' ENTERPRISE ages v 
APPLICATION PLATFORM 6.1.0.GA 





Profile Runtime 






日 Server Deployments 


Overview 


Deployments 


Currently deployed application components. 


日 Status 
Available Deployments 


日 Platform Add Remove En/Disable Replace 
JVM » rest-jersey-server.war vv » web Jersey Web Application 


Environment javax.ws.rs.core.Application 


日 Subsystems 
Datasources 


JPA 








JNDI View 
Transactions 
Transaction Logs 
Web 
Deployment Web Subsystem 
‘Webservices 
Name: web 
Context Root: /rest-jersey-server 
Virtual Host: default-host 
1.5.2.Final-redhat-1 aTools £Settings @ Logout 








图 11-2: JBoss Web 管理 界面 


JBoss 是 一 个 功能 齐备 的 应 用 服务 器 ， 打 包 了 很 多 有 用 的 模块 ， 这 可 以 最 大 限度 地 减少 你 
需要 打包 到 一 个 WAR 包 里 的 代码 。 但 当 你 的 应 用 里 有 和 JBoss 相似 的 模块 时 ， 也 会 产生 
一 些 不 易 发 现 的 错误 。 本 章 提供 的 WAR 文件 包含 了 Jersey 和 它 的 依赖 。 在 部 署 过 程 中 ， 
包含 Jersey 会 出 错 。RestEasy (包含 在 JBoss 中 ) 会 报错 ， 默 认 情 况 下 ， 它 会 扫描 并 认定 
Jersey 是 一 个 实现 了 JAXRS 规范 的 冲突 。 解 决 方案 是 为 web.xml 添加 上 下 文 变量 以 关闭 
扫描 











<context-param> 
<param-name>resteasy.scan</param-name> 
<param-value>false</param-value> 

</context-param> 

<context-param> 
<param-name>resteasy.scan.providers</param-name> 
<param-value>false</param-value> 
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</context-param> 

<context-param> 
<param-name>resteasy.scan.resources</param-name> 
<param-value>false</param-value> 

</context-param> 





解决 方案 虽然 简单 ， 但 却 指 出 了 问题 所 在 : 尽管 JEE 规范 明确 定义 了 打包 机 制 ， 但 依然 不 
确定 哪些 服务 应 该 被 包含 进 一 个 特定 的 部 署 环境 。 这 些 特质 让 部 署 JEE 应 用 时 “一 次 编 
写 ， 随 处 部 署 ” 这 句 话 只 在 极为 严格 的 约束 下 才 成 立 。 











11.2.2 ”命令 行 管理 


初始 安装 应 用 时 ， 使 用 GUI 管理 很 方便 。 所 有 可 用 的 管理 选项 都 一 览 无 余地 显示 在 用 户 界 
面 上 ， 很 容易 理解 。 这 让 图 形 管理 界面 成 了 学 习 应 用 服务 器 和 检查 可 用 功能 的 理想 之 选 。 
和 所 有 GUI 一样 ， 与 命令 行 相 比 ， 它 们 没有 编写 脚本 并 自动 化 执行 的 功能 。 对 于 小 规模 部 
署 ， 命 令 行 只 是 增加 了 一 点 便利 ， 但 对 于 复杂 的 部 署 (或 者 拥有 大 量 服务 器 的 简单 部 署 ) 
场景 来 说 ,命令 行 就 是 必 不 可 少 的 了 。 
































JBoss 有 一 个 命令 行 接口 ， 可 以 通过 在 命令 行 提示 符 下 输入 指令 或 执行 脚本 来 进行 管理 。 
几乎 所 有 在 GUI 上 可 见 的 操作 都 可 以 通过 命令 行 完成 。 将 命令 行 接口 连接 到 一 个 正在 运行 
的 应 用 服务 器 上 就 可 以 初始 化 一 个 命令 行 会 话 。 为 此 ， 需 要 调用 ct， 使 用 -c 选项 (立即 
建立 一 个 到 应 用 服务 器 的 连接 ) : 








$bash bin/jboss-cli.sh -c 
登录 成 功 后 ， 可 键入 help 命令 获取 可 用 命令 列表 : 
[standalone@localhost:9999 /] help 


只 需 会 一 些 基 本 命令 就 可 以 执行 大 多 数 的 常用 操作 。 使 用 ts 命令 列 出 给 定 节 点 路 径 下 的 
所 有 内 容 : 


[standalone@localhost:9999 /] ls 


这 样 ， 在 JBoss 环境 下 ， 就 可 以 像 在 操作 系统 的 文件 系统 里 那样 ， 使 用 cd 命令 在 目录 间 跳 
转 ， 使 用 ts 命令 列 出 给 定 市 点 路 径 下 的 的 内 容 。 可 用 如 下 方式 查看 部 署 好 的 WAR 包 : 











[standalone@localhost:9999 /] ls deployment 
rest-jersey-server .War 


该 命令 行 的 语法 并 不 完全 和 操作 系统 中 的 一 致 。 比 如 ， 可 以 使 用 1s 命令 和 等 号 来 指定 部 
署 物 以 获取 WAR 包 的 更 多 信息 : 


[standalone@localhost:9999 /] ls /deployment=rest-jersey-server .war 
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JBoss 的 CLI 命令 被 设计 为 可 在 外 部 脚本 中 执行 。 下 面 的 命令 展示 了 如 何在 操作 系统 的 命 
窗口 中 打印 当前 部 署 列表 : 





$bash bin/jboss-cli.sh -c --commands='ls deployment' 














CLI 让 编写 复杂 脚本 和 应 用 服务 器 、 操 作 系 统 及 其 他 应 用 交互 成 为 可 能 。 上 述 例子 只 
了 查询 操作 ， 但 CLI 的 功能 不 止 这些 。 它 还 可 以 修改 应 用 服务 器 状态 ， 比 如 音 
署 一 个 WAR 包 : 





[standalone@localhost:9999 /] undeploy rest-jersey-server .War 
[standalone@localhost:9999 /] deploy /tmp/rest-jersey-server .war 


对 于 很 多 管理 任务 ， 管 理 员 都 可 以 将 GUI 人 工交 互 的 方式 替换 为 CLI 脚本 ,但 CLI 有 自 
己 的 语法 和 组 织 方式 ， 需 要 花 时 间 学 习 才 能 有 效 使 用 。 如 果 只 关心 如 何 部 署 一 个 应 用 ， 那 
么 既 不 必 使 用 GUI， 也 不 必 使 用 CLI， 直 接 将 文件 复制 到 指定 部 署 目 录 下 即 可 。JBoss 的 
部 署 扫 描 仪 会 扫描 该 目 孙 ， 自 动 部 署 应 用 。 复 制 操 作 可 以 手动 ， 也 可 以 使 用 脚本 ， 因 此 即 
使 不 学 习 CLI， 也 能 自动 部 署 。 需 要 经 常 进行 部 署 的 开发 者 可 选择 这 种 复制 的 方式 ， 依 赖 
部 署 扫描 仪 或 者 集成 进 他 们 标准 工具 链 里 的 钧 子 程序 。 人 们 为 Maven 和 其 他 构建 工具 以 及 
IDE 编写 了 插件 (http://docs.jboss.org/jbossas/7/plugins/maven/7.4.Final/examples/deployment- 
example.html) ， 将 应 用 部 署 集成 进 构建 流程 里 。 


11.3 ” 非 JEE 应 用 的 部 署 


长 久 以 来 ，Java Web 开发 等 同 于 JEE (Java 企业 版 )。Java 开发 者 吃惊 "地 发 现 JEE 模型 
并 不 是 Web 应 用 部 署 的 唯一 方式 ， 而 且 对 于 特定 系统 ， 甚 至 可 能 还 不 是 最 好 的 部 署 方 式 。 
Java 技术 不 局 限于 开发 Web 应 用 ，JEE 也 只 是 在 Java 平 台 上 开发 Web 应 用 的 可 能 方式 之 
一 。 图 11-3 展示 了 Java Web 应 用 的 开发 模型 。 






















































































Java 技 术 














11-3; 使 用 Java 开发 Web 应 用 





注 1: 原文 是 “It can be jarring (pun intended) for Java developers to realize”， 作 者 使 用 了 形容 词 jarring， 
一 语 双关 ， 同 时 还 有 Java 中 打包 的 命令 jar。 
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部 署 一 个 非 JEE Web 应 用 时 ， 不 需要 事前 安装 应 用 服务 器 。 从 Web 应 用 的 角度 看 ， 应 用 
服务 器 提供 的 上 下 文 环境 在 外 部 、 内 部 或 与 之 并 行 。 这 并 不 是 应 用 服务 器 特有 的 选项 ， 其 
他 提供 独立 服务 的 应 用 (比如 数据 库 ) 也 是 如 此 。 


11.3.1 服务 器 在 应 用 之 外 

应 用 服务 器 是 一 种 复杂 且 成 熟 的 软件 ， 已 经 面世 很 多 年 了 。 过 去 ， 受 磁盘 和 处 理 器 限制 ， 
以 及 配置 的 复杂 性 ， 人 们 不 得 不 花费 大 量 时 间 和 精力 安装 它 。 安 装 好 后 ， 才 能 安装 和 配置 
Web 应 用 连接 已 有 服务 。 如 图 11-4 所 示 ，Web 应 用 是 跑 在 服务 器 “上 ”的 。 应 用 服务 器 
是 Web 应 用 的 部 署 目标 ， 其 本 身 处 在 Web 应 用 “之 外 ”。 




































































11-4: 应 用 服务 器 在 Web 应 用 之 外 


这 事实 上 就 是 本 章 前 面 讲述 的 JEE 的 部 署 方式 。 当 你 需要 将 应 用 部 署 至 已 运行 应 用 服务 器 
的 内 部 系统 中 ， 或 是 希望 将 多 个 Web 应 用 和 JEE 包 打 包 进 一 个 Web 应 用 时 ， 这 种 方式 很 
好 用 。 很 多 时 候 ， 应 用 不 需要 什么 管理 ， 可 能 就 需要 放 在 一 个 应 用 服务 器 或 者 servlet 容器 
里 来 运行 ， 但 是 不 需要 任何 管理 。 这 就 让 开发 者 在 部 署 自己 的 Web 应 用 时 ， 才 想起 部 署 应 
用 服务 器 。 























使 用 轻 量 级 容器 成 为 趋势 
应 用 的 虚拟 化 和 轻 量 级 部 署 是 大 势 所 趋 ， 这 就 需要 抛弃 庞大 的 、 整 体式 且 需 人 工 安装 
配置 的 应 用 服务 器 。 基 于 云 的 部 署 方式 的 出 现 让 服务 器 的 概念 变 得 模糊 了 。 这 种 方式 
要 求 部 署 速 度 快 、 尽 可 能 简单 ， 并 且 高 度 自动 化 。 











11.3.2 ”服务 器 和 应 用 并 行 

不 事先 安装 应 用 服务 器 的 情况 下 ， 也 有 几 种 方式 可 以 部 署 Web 应 用 。 一 种 方式 是 将 Web 
应 用 和 应 用 服务 器 捆绑 在 一 起 。 应 用 服务 器 是 独立 的 ， 部 署 时 和 Web 应 用 并 行 安 装 在 一 
起 ， 如 图 11-5 所 示 。 
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一 
应 用 服务 器 | 记 ”xx  ) 


服务 器 








11-5; 服务 器 和 应 用 并 行 


这 种 部 署 方式 在 Rails 里 很 流行 ， 它 本 身 包含 一 个 服务 器 (WEBrick,，http://www.ruby-dorc. 
org/stdlib-2.0.0/libdoc/webrick/rdoc/) 和 框架 。Play 和 Roo 从 Rails 那里 得 到 启示 ， 也 使 用 
这 种 部 署 方式 ， 不 过 要 依赖 Java Web 容器 。Maven 的 Jetty 插件 (如 图 11-6 所 示 ) 是 另 一 
个 示例 ，Web 应 用 部 署 后 ， 可 立即 在 Servlet 容器 中 运行 ， 前 提 是 不 需要 外 部 维护 和 管理 。 
使 用 本 章 提供 的 项 目 ， 读 者 可 自行 构建 Web 模块 ， 并 使 用 下 述 命令 在 Jetty 上 运行 生成 的 
WAR 包 : 



































mvn clean install jetty:run 
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11-6: 运行 在 Maven Jetty 插件 中 的 Web 应 用 





通过 端口 9090 就 可 以 访问 该 应 用 了 。 











使 用 Jetty 时 ，Maven 并 不 需要 运行 Web 应 用 。 可 以 用 Jetty Runner (http://wiki.eclipse.org/ 
Jetty/Howto/Using_Jetty_Runner) 将 Jetty 打包 进 一 个 JAR， 在 命令 行 下 使 用 。 在 build 目录 
下 ， 将 路 径 和 WAR 作为 参数 传 给 Jetty Runner: 





curl -0 http://repo2.maven.org/maven2/org/mortbay/jetty/jetty-runn 
er/8.1.9.v20130131/jetty-runner-8.1.9.v20130131.jar 


java -jar jetty-runner-8.1.9.v20130131.jar \ 
--path /jersey-server \ 
target/rest-jersey-server .war 





打包 和 部 署 | 153 





Tomcat Runner (https://devcenter.heroku.com/articles/java-webapp-runner) 是 另 一 个 使 用 Tomcat 
的 类 似 项 目 (https://github.com/jsimone/webapp-runner)。 它 的 参数 和 使 用 Jetty Runner 时 一 样 : 





java -jar webapp-runner-7.0.40.0.jar \ 
--path /jersey-server \ 
target/rest-jersey-server .war 


11.3.3 ”服务 器 在 应 用 里 面 
除了 使 用 一 个 外 部 服务 器 ， 还 可 以 在 应 用 代码 中 包含 一 个 Java 服务 器 库 ， 如 图 11-7 所 示 。 
服务 器 是 在 Web 应 用 里 面 运行 的 。 第 6 章 有 几 个 案例 ， 展 示 了 可 这 样 使 用 的 几 个 库 的 框架 。 
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11-7: 服务 器 在 Web 应 用 里 面 


使 用 这 种 将 服务 器 包 在 应 用 里 的 方式 ， 发 布 时 仅 需 创 建 和 部 署 一 个 可 执行 的 JAR 包 ， 就 可 
以 放 在 服务 器 上 运行 。JEE 标准 并 没有 考虑 到 JAR 或 应 用 服务 器 可 以 这 样 使 用 ， 而 是 像 前 
而 描述 过 的 ， 假 设 应 用 会 部 署 到 一 个 已 经 配置 好 的 环境 中 ， 提 供 了 诸如 HTTP 处理、 数据 
库 连 接 这 样 的 服务 。 

















合并 可 执行 的 JAR 包 





尽管 在 Java 项 目 里 引用 多 个 JAR 包 的 情况 很 常见 ， 但 是 一 个 项 目 也 能 以 一 
个 单独 的 可 执行 单元 进行 打包 和 部 署 。 将 JAR 包 打 包 进 另 一 个 JAR 包 的 
工具 有 one-jar (http://one-jar.sourceforge.net/)， 还 有 构建 工具 的 插件 ， 比 如 


























Maven Shade plug-in (http://maven.apache.org/plugins/maven-shade-plugin/) 。 


11.4 不 同 部 署 方 式 带 来 的 影响 


部 署 方式 的 选择 会 对 应 用 的 安全 性 、 扩 展 性 及 整体 支持 带 来 显著 影响 。 应 对 快速 变化 时 ， 
不 同 的 部 署 方式 在 灵活 性 上 有 所 差异 。 








或 许可 以 在 单个 服务 器 上 简单 部 署 展 开 的 EAR 或 WAR 包 ， 为 系统 打 热 补丁 ， 这 样 即 使 更 
新 代码 或 配置 文件 ， 也 不 需要 再 重新 完整 地 部 署 一 遍 。 这 种 方式 会 引发 大 量 安全 问题 ， 但 
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更 致命 的 是 ， 在 复杂 的 部 署 场景 下 ， 这 种 改动 是 行 不 通 的 。 


应 用 服务 器 在 外 部 管理 时 ， 很 容易 修改 数字 赁 证 和 连接 字符 串 。 而 当 应 用 和 应 用 服务 器 并 
行 部 署 或 将 应 用 服务 器 打包 进 应 用 时 ， 则 不 会 这 样 。 


应 用 服务 器 不 依赖 外 部 管理 的 部 署 方式 为 水 平 扩 展 提 供 了 更 大 的 灵活 性 。 通 过 构建 智能 的 
负载 均衡 器 ， 不 用 改变 现 有 服务 器 ， 而 是 建立 新 的 并 且 按 期 望 配置 好 的 服务 器 ， 让 人 们 能 
以 最 短 的 宕 机 时 间 快 速 响应 变化 。 


部 署 方式 的 不 同 也 会 影响 开发 流程 和 对 应 用 基础 的 选 型 。 最 好 在 开发 流程 初期 就 确定 好 部 
署 目 标 ， 以 确保 所 需 资源 的 就 位 和 相关 流程 的 制订 。 


11.4.1 负载 均衡 

负载 均衡 和 部 署 方 式 紧 密 相连 ， 它 的 实现 方式 决定 了 运行 应 用 的 网 络 和 服务 器 拓扑 结构 。 
负载 均衡 的 目的 是 在 现 有 处 理 器 能 力 下 ， 尽 可 能 高 效 地 分 发 进来 的 请 求 。 以 Web 应 用 为 
例 ， 进 来 的 HITTP 请 求 经 指定 的 负载 均衡 服务 器 (或 服务 器 集群 ) 重 定向 到 多 台 Web 服 
务 器 。 


根据 处 理 每 个 请 求 的 工作 量 、 服 务 器 的 处 理 能 力 和 执行 负载 均衡 操作 所 选择 的 硬件 或 软件 
的 不 同 ， 分 发 请 求 的 方式 也 不 同 。 可 以 采用 轮 询 方式 在 服务 器 之 间 平 均 分 配 任务 ， 也 可 以 
根据 权重 将 更 多 任务 分 配给 处 理 能 力 更 强 的 服务 器 。 还 有 更 复杂 的 调度 方案 ， 有 的 会 记录 
每 台 服 务 器 处 理 的 请 求 ， 有 的 则 让 服务 器 在 空闲 时 自动 拉 取 任务 执行 ， 这 些 方式 均 能 更 好 
地 利用 现 有 的 处 理 器 能 力 。 有 一 些 负 载 均衡 器 能 检测 出 失效 市 点 ， 不 会 将 请 求 分 发 到 这 些 
市 点 上 上。 负载 均衡 的 工作 机 制 如 图 11-8 所 示 。 


































































































图 11-8: 负载 均衡 的 工作 机 制 
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不 是 所 有 物理 负载 均衡 器 的 功能 都 能 被 软件 负载 均衡 器 替换 。 这 其 中 包括 一 些 安全 方面 的 
考虑 ， 比 如 分 布 式 拒绝 服务 防范 和 SSL 终止 ， 还 有 一 些 有 助 提 升 性 能 的 特性 ， 比 如 压缩 、 
连接 池 、 缓 冲 区 和 缓存 。 这 些 功能 并 不 一 定 是 负载 均衡 所 特有 的 ， 但 有 时 高 效 地 使 用 它们 
非常 必要 。 

















更 多 关于 负载 均衡 的 介绍 

负载 均衡 的 很 多 方面 其 实 和 客户 端 一 服务 器 端的 Web 开发 无 关 。JBoss 有 一 个 内 部 的 
负载 均衡 (http:Wjbossclustering.jboss.org/) ， 在 集群 环境 下 为 JNDI、RMI 和 EJBs 提 
供 服务 。 它 和 其 他 许多 Web 容器 都 包含 集群 功能 ， 让 会 话 在 多 台 应 用 服务 器 上 都 是 
可 用 的 。 根 据 是 否 将 来 自 同 一 个 客户 痛 的 多 个 请 求 定向 到 一 台 服 务 器 ， 不 同 的 负载 均 
衡 有 不 同 的 策略 。 基 于 DNS 的 负载 均衡 和 轮 询 的 方式 类 似 ， 但 是 客户 谢 缓 存 了 服务 
器 IP， 在 第 一 次 查找 后 会 返回 同一 个 服务 器 。 粘 滞 会 话 将 和 同一 个 会 话 关联 的 HTTP 
请 求 发 送 至 同一 个 服务 器 。 负 载 均 衡 的 范围 很 大 ， 从 对 负载 均衡 器 的 内 部 管理 的 独立 
操作 到 AWS Elastic Load Balancing (http://aws.amazon.com/cn/elasticloadbalancing/) 
这 样 的 云 部 署 方式 。 你 可 以 翻阅 有 关 它 们 的 文档 (http://docs.aws.amazon.com/ 
ElasticLoadBalancing/latest/DeveloperGuide/elastic-load-balancing.html) 和 过 去 对 基础 
技术 (http://oreil.ly/server-load-balancing) 的 讨论 ， 从 而 获取 更 多 信息 以 深入 了 解 负 
载 均 衡 。 











开发 者 即使 不 直接 参与 负载 均衡 ， 了 解 足 够 的 知识 去 设计 和 制订 部 署 方 案 也 是 非常 重要 
的 。 无 状态 的 处 理 不 再 要 求 会 话 ， 这 是 需要 着 重 调整 的 地 方 。 安 全 配置 也 会 受到 影响 。 后 
续 支 持 需 要 理解 应 用 日 志 。 如 果 不 知 道 网 络 是 如 何 建立 的 ， 就 不 能 有 效 地 利用 日 志 中 的 请 
求 和 响应 记录 来 诊断 故障 。 











应 用 服务 器 集群 


应 用 服务 器 或 Web 容器 集群 可 以 代替 负载 均衡 。 它 能 分 散 服务 器 端 应 用 的 
负载 ， 从 而 达到 同样 的 目的 。 甚 实现 细节 没有 标准 化 ， 也 并 非 适用 于 所 有 服 
务 器 。 集 群 在 商用 项 目 上 尤其 常见 ， 但 和 其 他 企业 级 解决 方案 一 样 ， 很 贵 。 
负载 均衡 可 能 也 会 引入 昂贵 的 硬件 和 软件 ， 但 不 是 非得 如 此 。 最 基本 的 负载 
均衡 原理 已 经 被 大 家 擎 握 ， 可 以 使 用 通用 的 、 和 厂商 无 关 的 网 络 配置 (防止 
在 不 同 应 用 服务 器 间 厚 此 薄 彼 ) 来 实现 。 




















11.4.2 自动 化 应 用 部 署 

为 了 方便 于 控制 可 能 部 署 场景 的 复杂 性 ， 人 们 开发 出 了 很 多 工具 。 早 在 20 世纪 90 年 代 ， 
就 有 针对 cfengine 的 专用 脚本 让 工作 站 的 管理 实现 自动 化 。 它 是 一 种 非常 轻 量 级 的 工具 ， 
这 么 多 年 来 一 直 有 人 在 维护 。 它 支持 多 种 操作 系统 (包括 Windows、Mac OS X 和 其 他 一 
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些 操作 系统 ) ， 这 将 它 和 那些 为 特殊 Web 应 用 定制 的 工具 区 分 开 来 。 


Capistrano 是 一 种 在 多 台 远 程 机 器 上 并 行 执行 SSH 命令 的 实用 工具 。 它 是 基于 Ruby， 并 且 
面向 Web 应 用 的 部 署 ， 这 和 它 来 源 于 Ruby on Rails 的 生态 系统 是 分 不 开 的 。Capistrano 的 
典型 应 用 之 一 是 从 SCM 系统 中 签 出 Web 应 用 ， 将 其 部 署 至 多 台 远 程 服务 器 上 。Fabric 是 
Python 版 的 Capistrano。 由 于 云 部 署 环境 下 服务 器 的 透明 性 ， 这 些 工具 常 和 Puppet、Chef、 
Ansible 和 Salt 诸如 此 类 的 配置 管理 工具 放 在 一 起 考虑 。 


11.5 项 目 


前 面 已 经 展示 过 如 何 部 署 本 章 的 项 目 。 这 个 项 目 是 一 个 简单 的 客户 端 一 服务 器 端 架构 的 
Web 应 用 ， 提 供 CRUD 操作 ， 用 来 添加 、 更 新 和 删除 图 书 。 这 个 例子 没有 数据 存储 功能 ， 
用 了 一 个 数组 保存 添加 的 图 书 ， 当 服务 器 重启 时 ， 数 据 就 丢失 了 。 


应 用 的 架构 反映 在 pom.xml 和 web.xml 中 。pom.xml 包含 和 Jersey 相关 的 模块 ， 将 它 作 为 
依赖 实现 了 JAX-RS 风格 的 API， 输 出 JSON。web.xml 区 分 开 API 的 客户 端 和 服务 器 端 ， 
并 指明 index.html 为 欢迎 页 面 ， 是 应 用 客户 端的 入 口 。 




































































11.5.1 客户 端 


index.html 包含 和 应 用 相关 的 HTML、CSS 和 JavaScript。 通 过 CDN 的 方式 提供 jQuery。 
JavaScript 代码 内 和 骨 在 script 标签 里 。jQuery 的 getJSON 和 ajax 方法 用 来 调用 API。jQuery 
的 $( document ).ready() 国 数 调用 List 函数 ， 该 函数 以 JSON 格式 获取 图 书 列表 ， 然 后 在 
该 列表 上 迭 代 ， 将 每 个 条 目 放 到 一 个 div 里 显示 (该 div 通过 delete 类 锚 定 ) ， 最 后 加 到 用 
CSS 类 listing 查询 到 的 段落 对 象 后 。DELETE 操作 绑 定 到 全 局 文档 对 象 (而 不 是 每 一 个 
div) 上 ， 以 确保 所 有 属于 delete 类 的 超 链 接 都 能 响应 事件 (如果 直接 和 delete 类 绑 定 ， 
那么 只 能 和 页 面 初 始 化 时 存在 的 元 素 绑 定 )。Bootstrap 也 是 以 CDN 的 形式 引入 的 。 为 保持 
简约 ， 该 应 用 并 没有 在 很 多 地 方 使 用 它 ， 把 它 包含 进来 作为 起 点 只 是 为 了 增加 一 些 样式 。 
































这 是 一 个 最 基本 的 实现 ,但 已 经 足够 说 明 这 种 基于 DOM 操作 、 没 有 MV* 框架 ， 也 没有 
使 用 CSS 框架 的 前 端 架 构 的 局 限 性 。 








首先 ， 使 用 了 一 个 内 内 的 样式 将 页 面 居中 ， 这 是 非常 不 Bootstrappy 的 方式 。Bootstrap 和 
其 他 响应 式 Web 框架 依赖 基于 网 格 的 布局 方式 。 修 改 HTML， 让 其 使 用 网 格 ， 从 而 更 适 
合 在 不 同 的 设备 上 显示 。 

















另外 ，DOM 操作 很 难 可 视 化 。 在 加 载 一 些 记录 后 ，HTML 页 面 的 初始 状态 已 经 不 能 7 
格 代 表 DOM 的 状态 ， 这 就 表明 一 个 视图 化 的 模板 系统 可 能 是 有 用 的 。 除 了 笨拙 地 将 
JavaScript 代码 舱 入 页 面 ， 也 没有 按 功 能 将 代码 划分 成 块 。MV* 框架 为 应 用 提供 了 初始 架 
构 ， 可 以 更 好 地 管理 JavaScript 代码 。 
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11.5.2 ”服务 器 端 


所 有 Web API 都 包含 在 一 个 BookService 类 中 ， 
端的 @Path 注释 表明 该 类 被 books 引用 。GET、 





在 web.xml 映射 到 /api 这 个 URL。 类 最 上 
PUT 和 了 DELETE 方法 用 来 读 取 、 创 建 和 删 





除 图 书 资源 。@produces 注释 表明 每 个 JSON 调用 都 返回 application/json 的 格式 。 在 方 
法 层面 ，@Path 注释 引用 的 {book} 映射 为 ePathParam， 传 递 相 应 方法 的 参数 。 











通常 要 使 用 库 来 创建 JSON， 本 例 使 用 了 Mention Apache IO Utils 连接 字符 串 创 建 JSON。 





API 的 调用 可 以 在 浏览 器 里 验证 和 测试 ， 也 可 








以 使 用 如 Curl 这 样 的 工具 。 在 Maven 插件 





定义 的 上 下 文中 ， 可 以 通过 下 述 命令 插入 一 条 记录 : 


curl -X PUT http://127.0.0.1:9090/api/books/4?titLe=CLient+Server+Neb+Apps 


11.6 小结 


过 去 儿 年 ， 遵 循 JEE 流程 的 Java 应 用 部 署 方式 已 经 得 到 了 很 好 的 定义 。 虽 然 JEE 风格 的 





部 署 方式 在 很 多 情况 下 还 是 适用 的 ， 但 Java 神 


上 区 还 是 采用 了 新 的 部 署 方 式 ， 尤 其 是 对 于 


客户 端 - 服务 器 端 风格 的 Web 应 用 。 下 一 章 将 讲述 新 出 现 的 、 应 用 于 云 环境 中 的 虚拟 化 技 








术 ， 它 表明 在 很 多 情况 下 ， 将 应 用 服务 器 打包 到 应 用 中 或 者 和 应 用 并 行 ， 比 传统 的 将 应 用 


服务 器 放 在 应 用 之 外 的 方式 要 好 。 
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第 12 章 


虚拟 化 





人 们 不 懂得 欣赏 事物 的 本 质 ， 太 空中 的 物体 ， 人 们 总 了 本 质 。 
一 一 具 伯 . 尔 利 (Firefly ，Objects in Space) 


一 提起 “计算 机 ”这 个 词 ， 人 们 脑海 中 会 立刻 蹦 出 一 堆 实 体 机 形象 ， 可 能 是 一 台 显 示 器 和 
一 个 键盘 、 一 台 笔 记 本 电脑 ， 或 者 是 一 排 排 服务 器 。 不 管 是 哪 种 情况 ， 都 是 一 种 有 形 的 、 
具体 的 实物 。 在 软件 开发 中 ， 这 种 对 计算 机 的 普遍 印象 就 不 是 特别 有 用 了 ， 因 为 硬件 的 物 
理 细节 被 一 层 抽 象 的 软件 给 屏 滴 了 。 虚 拟 化 描述 了 一 种 隐藏 实现 细 市 的 技术 ， RN 
用 于 硬件 品 台 、 操 作 系统 、 存 储 设 备 和 网 络 资源 中 。 虽 然 这 和 我 们 本 书 所 讲 的 客户 端 

务 器 端 Web 开发 方式 或 者 其 他 开发 方式 不 直接 相关 ， 但 却 是 一 个 有 趣 的 话题 ， 
用 都 需要 大 规模 部 署 ， 而 大 规模 部 署 需 要 建立 在 虚拟 化 解决 方案 上 。 虚 拟 化 是 个 强大 的 概 
念 ， 它 影响 应 用 开发 、 部 署 、 扩 展 和 灾难 恢复 的 方方面面 。 


12.1 全 虚拟 化 


没有 虚拟 化 ， 服 务 器 就 定义 和 受 限 于 物理 约束 。 服 务 器 管理 员 根 据 硬 件 情况 和 实际 需求 ， 
构建 和 配置 有 一 系列 特定 选项 的 服务 器 。 开 发 团队 中 的 成 员 参 照 目 标 服务 器 的 配置 ， 为 自 
己 的 机 器 安装 同样 的 软件 ， 进 行 同样 的 配置 。 如 遇 硬件 限制 、 性 能 瓶颈 或 容量 问题 ， 一 般 
通过 增加 硬件 来 解决 。 有 时 也 会 用 到 一 些 自动 化 手段 ， 但 多 数 情况 下 ， 由 于 硬件 的 差别 ， 
日 常 工 作 主要 靠 手 动 完 成 。 如 果 有 大 量 的 不 同 服务 器 需要 维护 ， 复 杂 的 备份 和 恢复 行动 就 



























































注 1: 详 见 http://en.wikipedia.org/wiki/Firefly_(TV_series)。 具 伯 … 尔 利 是 剧 中 人 物 Jubal Early。 
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成 了 保持 系统 正常 工作 和 可 靠 性 的 当务之急 。 


通过 用 虚拟 机 替代 物理 服务 器 的 虚拟 化 方式 ， 可 以 在 某 种 程度 上 缓解 这 种 挑战 。 全 虚拟 化 
试图 提供 一 套 完 整 的 、 从 基础 硬件 到 运行 在 虚拟 机 上 的 独特 且 性 能 未 改 的 操作 系统 的 仿 
真 。 图 12-1 展示 了 虚拟 化 技术 的 发 展 ， 从 传统 的 、 持 和 久 的 、 需 要 手动 配置 的 物理 硬件 到 高 
度 透明 的 虚拟 机 ， 这 些 虚 拟 机 是 自动 创建 的 ， 有 些 其 至 只 在 云 中 短暂 存活 儿 秒 钟 。 





























传统 服务 器 
持久 性 六 
虚拟 服务 器 
用 时 性 a 
云 服 务 器 。 。 和 罗 











图 12-1: 服务 器 类 型 


使 用 虚拟 机 可 降低 维护 物理 服务 器 带 来 的 挑战 。 由 于 全 虚拟 化 技术 完全 模拟 了 物理 硬件 ， 
每 个 开发 者 都 拥有 独立 的 环境 进行 新 软件 测试 ， 而 不 用 花费 金钱 购买 和 维护 额外 的 机 器 。 
一 台 物 理 服 务 器 上 可 创建 多 个 虚拟 机 ， 安 装 不 同 的 操作 系统 以 测试 软件 。 所 有 需要 安装 的 
软件 都 可 以 在 虚拟 机 里 事先 配置 好 。 可 以 随时 为 机 器 当前 状态 创建 快照 的 能 力 为 灾难 恢复 
提供 了 很 多 可 能 。 与 管理 大 量 的 、 硬 件 千差万别 的 物理 机 相 比 ， 将 服务 器 替换 为 虚拟 机 既 
减少 了 能 源 消 耗 ， 又 降低 了 硬件 成 本 。 


























然而 虚拟 机 并 不 是 一 本 万 利 的 ， 它 需要 额外 的 处 理 。 首 先 ， 必 须 购买 虚拟 化 软件 ， 其 次 ， 
运行 它们 需要 占用 额外 的 处 理 器 资源 。 对 于 那些 需要 访问 底层 硬件 的 项 目 来 说 ， 虚 拟 化 并 
不 适用 ,但 对 于 大 多 数 Web 应 用 ， 虚 拟 化 是 个 很 好 的 选择 。 虚 拟 化 和 物理 硬件 的 关系 有 
点 像 高 级 语言 和 低级 语言 ， 比 如 C 或 者 汇编 语言 。 对 性 能 要 求 高 的 任务 需要 直接 对 “人 金 
属 裸 机 ”编程 ， 使 用 特殊 的 、 高 度 定制 的 方案 ， 而 其 他 为 数 众多 的 任务 则 没有 如 此 严格 的 
要 求 。 






































另 一 个 代价 是 需要 考虑 额外 的 复杂 性 。 和 关注 物理 服务 器 不 同 ， 虚 拟 机 的 行为 不 能 
来 理解 ， 而 是 需要 和 宿主 机 器 结合 起 来 考虑 。 性 能 问题 可 能 出 自 虚 拟 机 ， 也 可 能 出 
机 器 。 虚 拟 层 可 舱 套 ， 这 进一步 增加 了 复杂 度 。 虽 然 虚 拟 化 解决 了 很 多 问题 但 是 
技术 层面 去 了 解 它 ， 学 会 如 何 高 效 使 用 。 


虚拟 机 代替 物理 服务 器 的 流行 让 服务 器 管理 和 扩展 实践 发 生 了 巨大 变革 。 所 请 的 云 计 算 提 
供 商 以 各 式 各 样 的 方式 提供 了 大 量 虚拟 化 的 计算 资源 。 有 时 ， 虚 拟 化 的 形式 是 提供 具体 的 
机 器 ， 这 时 就 不 需要 管理 物理 服务 器 了 。 
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JVM 中 的 “Vy” 


Java 虚拟 机 (Java Virtual Machine，JVM) 提供 了 部 分 的 虚拟 化 ， 允 许 包 含 字 节 码 的 
类 文件 在 任何 运行 虚拟 机 的 硬件 上 解释 和 执行 。 但 它 没 有 提供 分 隔 代 码 的 容器 ， 因 此 
无 法 在 网 络 上 创建 可 作为 独立 服务 器 进行 管理 的 独特 机 器 。 任 何 形式 的 虚拟 化 都 有 效 
地 屏蔽 了 底层 实现 细节 ， 只 是 根据 问题 的 不 同 ， 实 现 的 层次 也 不 同村 了 。 











12.2 ”虚拟 机 的 实现 


虚拟 化 技术 要 追溯 到 20 世纪 60 年代 IBM 公司 的 一 个 研究 项 目 : CP-40。1967 年 IBM 推 
出 了 它 的 后 继 产 品 CP 67， 这 是 一 个 为 IBM System/360-67 开发 的 虚拟 机 操作 系统 。 此 后 
几 年 ， 虚 拟 化 解决 方案 不 断 涌现 ， 大 多 数 都 是 针对 特定 的 操作 系统 。 随 着 越 来 越 多 的 开发 
者 能 以 低廉 的 价格 获得 处 理 能 力 更 强 的 硬件 ， 虚 拟 化 技术 也 变 得 流行 起 来 。 

















在 当今 众多 的 虚拟 机 实现 里 ，VMWare、VirtualBox 和 Amazon EC2 无 疑 是 最 受 欢迎 的 。 
它们 也 是 使 用 类 似 Vagrant (http://docs.vagrantup.com/v2/why-vagrant/index.html) 和 Packer 
(http://www.packer.io/) 这 样 的 工具 来 创建 服务 器 时 支持 的 目标 平台 。 





12.2.1 VMWare 

很 多 Web 开 发 者 碰 到 的 第 一 个 虚拟 机 都 是 在 1999 年 发 布 的 VMWare (https://www. 
vmware.com/) 工作 站 。 现 在 的 VMWare 提供 从 云 管理 、 备 份 到 桌面 产品 相关 的 一 系列 虚 
拟 化 方案 。 另 外 ， 你 可 从 网 上 下 载 一 个 开源 版 (https:/my.vmware.com/web/vmware/info/ 


slug/desktop_end_user_computing/vmware_workstation/ 10_0#open_source) 的 VMWare。 



































12.2.2 VirtualBox 


2007 年 1 月 ， 开 源 版 本 的 VirtualBox (https://www.virtualbox.org/) 发 布 ， 这 是 一 个 可 以 
运行 在 Windows、Linux 和 OS X 上 的 全 虚拟 化 解决 方案 。 不 久 后 它 就 被 Sun 收购 ， 随 
后 Oracle 又 收购 了 Sun， 将 其 重新 命名 为 Oracle VM VirtualBox。 它 在 常用 功能 上 和 
VMWare 类 似 ， 但 在 一 些 非 技 术 功 能 上 优势 明显 ， 比 如 友好 的 软件 授权 、 付 费 功 能 、 易 
用 性 和 文档 。 




















12.2.3 Amazon EC2 

Amazon Machine Image (AMI) 是 定义 服务 器 配置 的 模板 ， 它 运行 在 Amazon Elastic 
Compute Cloud (Amazon EC2) 之 上 。 启 动 一 个 实例 时 ， 选 择 一 个 AMI， 随 后 它 成 为 云 中 
的 一 个 虚拟 服务 器 ， 因 此 ，AMI 仅 适 用 于 针对 Amazon Web 服务 的 部 署 。 
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12.3 虚拟 机 的 管理 


随 着 数量 和 复杂 性 的 增加 ， 管 理 虚拟 机 成 了 一 项 艰巨 的 任务 。 每 种 实现 都 有 自己 专 有 的 定 
义 和 维 护 虚 拟 机 的 机 制 。Open Virtualization Format (OVF) 是 打包 和 分 布 虚拟 机 的 公开 标 
准 ， 涉 及 很 多 关于 创建 和 维护 虚拟 机 的 值得 关注 的 项 目 。 























12.3.1 Vagrant 


虚拟 机 管理 的 挑战 之 一 是 ， 每 种 虚拟 化 技术 在 创建 和 维护 环境 时 都 有 自己 特定 的 流程 、 脚 
本 和 工具 。 在 VirtualBox、VMware、AWS 和 其 他 服务 提供 商 提供 的 虚拟 化 技术 之 上 ， 
Vagrant (http://www.vagrantup.com/) 提供 了 创建 和 配置 可 复制 、 可 移植 的 虚拟 机 的 机 制 。 
一 个 vagrant 命令 即 可 完成 所 有 相关 操作 。 


Vagrantfile 文件 包含 了 对 特定 机 器 的 配置 。 一 且 该 文件 就 绪 ， 就 需要 添加 一 个 金子 〈 创 
建 虚拟 机 的 基础 镜像 )。 这 是 一 个 通过 克隆 得 到 的 初始 镜像 ， 从 未 被 修改 过 。 盒 子 添加 
后 ， 可 以 使 用 vagrant up 命令 启动 虚拟 机 ， 通 过 ssh 使 用 vagrant ssh 访问 新 创建 的 虚 
拟 机 。 还 有 其 他 命令 用 来 提供 一 种 机 器 以 停止 和 清除 旧 的 虚拟 机 和 盒子 。Vagrant 的 创始 
人 Mitchell Hashimoto (http://mitchellh.com/) 编写 了 一 本 关于 Vagrant 的 书 (http://shop. 
oreilly.com/product/0636920026358.do) ， 该 书 深入 讲解 了 Vagrant。 他 最 近 还 开发 了 一 个 名 
为 Packer 的 新 项 目 ， 该 项 目 简化 了 跨 VM 实现 的 配置 。 


























12.3.2 Packer 


虽然 Vagrant 很 好 用 ， 但 是 创建 和 维护 镜像 仍然 是 一 个 烦琐 、 困 难 且 大 部 分 需要 人 工 操 作 
的 过 程 。Packer (http://www.packer.io/) 使 用 一 种 可 移植 的 输入 格式 编写 模板 ， 从 而 可 并 
行为 多 平台 生成 镜像 。Packer 为 各 虚拟 机 提供 商 自 动 生成 基础 镜像 。Packer 中 的 创建 者 组 
件 以 构件 的 形式 为 指定 平台 创建 虚拟 机 镜像 。 


举 个 例子 ，Packer 中 的 VirtualBox 构件 能 创建 VirtualBox 虚拟 机 ， 并 将 其 以 OVF 格式 
导出 。 构 件 由 ID 或 者 表示 虚拟 机 镜像 的 文件 组 成 。Packer 呼应 了 Vagrant 的 功能 ， 使 用 
post-processors 可 以 获取 构件 并 将 其 转换 成 Vagrant 盒子 。 


使 用 一 致 的 语法 和 工作 流 为 不 同 提供 商 配 置 虚拟 机 的 做 法 并 没有 考虑 提供 和 维护 虚拟 机 ， 
使 用 一 些 shell 脚本 能 初步 加 入 一 些 自动 化 。 针 对 OS X 的 csshX (https://code.google.com/ 
p/csshx) 增强 了 控制 台 能 力 ， 可 以 对 多 台 机 器 运行 ssh 命令 ， 还 有 像 Capistrano (http:// 
capistranorb.com/) 这 样 的 工具 ， 在 小 型 环境 中 管理 多 个 服务 器 是 够 用 的 ， 但 是 当 服 务 器 数 
量 增 加 时 ， 这 些 方 案 对 于 一 般 性 的 系统 管理 任务 就 捉襟见肘 了 。 





























162 | 第 12 章 


12.3.3 ”DevOps 配 置 管理 

可 以 通过 命令 行 或 Vagrantfile 文件 中 引用 的 Shell 脚本 创建 简单 的 Vagrant 机 器 ， 更 复杂 
的 配置 则 需要 使 用 Chef (http://www.getchef.com/chef/) 或 Puppet (https://docs.puppetlabs. 
com/) 自动 化 安装 和 配置 虚拟 机 。Puppet 和 Chef 都 是 用 Ruby 编写 的 ， 不 过 Puppet 使 用 
一 种 基于 JSON 的 语言 ， 根 据 依赖 描述 决定 安装 什么 ， 而 Chef 仅 需 要 使 用 Ruby 来 编写 
安装 脚本 。 最 近 又 出 现 了 Ansible (https://github.com/ansible/ansible) 和 Salt (http:Wwww， 
saltstack.com/) ， 它 们 提供 了 其 他 可 选 方案 (或 者 说 补充 方案 )。 这 些 工具 在 功能 上 存在 大 
量 的 重合 ， 但 是 每 件 工 具 都 各 有 所 长 ， 适 合 特 定 的 项 目 和 管理 员 。 
































表 12-1 列 出 了 DevOps 配置 管理 工具 。 


表 12-1: DevOps 配 置 管理 工具 



































工具 初始 发 布 日 期 ”说明 

CFEngine (http://cfengine.com/community/download/) 1993 基于 C 语 言 ， 快 速 、 轻 量 级 ， 学 习 
曲线 陡峭 

Capistrano (http://capistranorb.com/) 2005 主要 针对 Rails 应 用 的 部 署 

Puppet (https://docs.puppetlabs.com/) 2005 灵感 源 自 CFEngine 

Chef (http://www.getchef.com/chef/) 2009 使 用 Ruby 配置 

Salt (http://www.saltstack.com/) 2011 快速 、 大 型 系统 的 协调 和 管理 

Ansible (https://github.com/ansible/ansible) 2012 简单 、 不 需要 代理 即 可 配置 








标注 出 初始 发 布 日 期 有 助 于 读者 理解 工具 的 角色 以 及 和 已 有 工具 之 间 的 关系 。Puppet 受到 
了 CFEngine (http://cfengine.com/product/what-is-cfengine/#puppet) 的 启发 ，Chef 的 作者 从 
Puppet 的 使 用 中 学 到 了 很 多 (http://docs.getchef.com/chef_why.html)， 但 是 在 管理 体验 上 采 
取 了 不 同 的 方式 。 最近， 与 流线型 工具 Chef 及 Puppet 类 似 的 Ansible (https://github.com/ 
ansible/ansible) 和 Salt (http:Wwww.saltstack.com/) 因 其 简单 和 平滑 性 ， 也 变 得 流行 起 来 。 
它们 都 能 够 初始 化 服务 器 配置 ， 并 且 执 行 命令 从 任意 节点 上 获取 结果 。 


















































DevOps 
科技 界 存 在 这 样 一 种 常见 现象 ， 当 工具 、 技 术 和 缩写 在 某 一 领域 出 现 的 次 数 达 到 一 定 
程度 后 ， 就 会 出 现 一 个 对 应 的 工作 职位 。DevOps 是 2009 年 出 现 的 一 个 概念 ， 它 代表 
了 一 种 职业 角色 ， 其 职责 涵盖 传统 的 开发 和 运营 工作 。 开 发 者 个 体 可 能 不 会 深入 使 用 
本 节 介 绍 的 工具 ， 但 是 了 解 这 些 工 具有 助 于 和 专业 DevOps 工程 师 进行 有 效 交 流 。 











12.4 ”容器 


全 虚拟 化 是 很 多 实用 应 用 的 早期 目标 ， 但 是 很 多 有 限 的 虚拟 化 形式 也 很 有 用 。 部 分 虚拟 化 
只 模拟 整个 操作 系统 的 一 部 分 ， 不 提供 完整 的 虚拟 机 。 操 作 系统 专 有 的 容器 技术 就 是 一 种 
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有 限 的 虚拟 化 形式 。 


进程 隔离 和 系统 安全 问题 驱动 了 容器 技术 的 发 展 ， 这 些 无 法 通过 操作 系统 本 身 的 机 制 实 
现 。 传 统 的 用 户 群 组 管理 很 麻烦 ， 而 且 对 很 多 情况 来 说 不 够 完善 。20 世纪 70 年代 末 ， 
chroot 实用 工具 实现 了 有 限 的 隔离 ， 尽管 在 有 些 情况 下 很 有 用 ， 但 它 欠 缺 运 行 一 个 独立 的 、 
功能 完整 的 容器 的 能 力 。 从 上 层 看 ， 容 器 是 一 个 部 分 的 虚拟 机 ， 从 底层 看 ， 容 器 是 一 个 增 
强 版 的 chroot。 








mM 











人 们 将 容器 描述 为 操作 系统 级 的 虚拟 化 ， 当 然 ， 各 厂商 自己 还 有 其 他 的 叫 法 。 它 在 容器 中 
提供 拥有 专用 资源 的 用 户 空间 ， 但 是 所 有 命令 均 在 宿主 机 器 内 核 中 运行 。 和 模拟 整个 机 器 
不 同 ， 容 器 技术 专注 于 在 服务 器 上 虚拟 化 彼此 独立 、 安 全 的 操作 系统 进程 。 











12.4.1 LXC 


LinuX Container (LXC，https://linuxcontainers.org/) 虚拟 化 可 用 于 Linux 系统 ， 它 允许 一 
台 服 务 器 上 运行 多 个 彼此 独立 的 容器 。 和 在 独占 系统 上 运行 标准 的 操作 系统 级 进程 相 比 ， 
它 在 资源 利用 和 安全 性 之 间 做 出 了 更 好 的 平衡 。 容 器 直接 运行 CPU 的 原生 指令 ， 而 不 必 
像 标 准 的 虚拟 化 技术 那样 需要 通过 中 间 步 又 ， 因 此 具有 更 好 的 性 能 。 由 于 没有 完整 操作 系 
统 所 需 的 开销 ， 因 此 容器 更 加 轻 量 级 ， 相 比 一 个 完整 的 虚拟 机 ， 会 占用 更 少 的 资源 。Linux 
容器 在 各 版 本 的 内 核 和 发 行 版 上 丝 可 运行 。 














12.4.2 Docker 


Docker (https:Wwww.docker.com/) 扩展 了 LXC， 提 供 了 更 高 级 别 的 API。 和 其 他 容器 技术 
类 似 ，Docker 试图 简化 应 用 的 打包 和 部 署 ， 为 终端 用 户 创建 彼此 独立 的 私有 环境 。 从 很 大 
程度 上 说 ，Docker 让 LXC 的 功能 使 用 起 来 更 为 简单 。 从 这 个 角度 看 ，Docker 之 于 LXC 就 
像 Vagrant 之 于 其 支持 的 底层 虚拟 机 实现 ， 如 图 12-2 所 示 。 


LXC 





























高 层 接 


















底层 实现 











12-2: Docker 和 Vagrant 的 高 层 API 


用 Docker 的 术语 来 说 ， 运 行 的 容器 基于 镜像 。 对 于 给 定 容 器 ， 其 文件 系统 状态 和 退出 值 
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被 保存 下 来 ,但 是 不 保存 内 存 状 态 。 容 器 可 以 被 启动 、 停 止 和 重启 。 容 器 也 可 通过 Docker 
的 commit 命令 导出 为 一 个 镜像 ， 这 个 镜像 随后 可 以 被 用 作 新 容器 的 监 本 。 


Docker 中 的 镜像 可 以 有 父 镜 像 ， 但 基础 镜像 没有 父 镜像 。 用 来 创建 容器 的 镜像 保存 于 
Docker 库 中 ，Docker 库 被 注册 到 一 个 注册 器 里 ，index.docker.io 是 隐 含 的 顶级 注册 器 ， 
因此 Docker 包含 了 发 布 和 共享 镜像 的 机 制 。 


虽然 这 是 一 个 新 项 目 ， 但 Docker 汗 力 巨大 ， 它 确保 能 在 分 布 式 环境 中 提供 标准 的 容器 。 
如 果 使 用 合理 ， 就 能 省 去 开发 者 和 系统 管理 员 安装 机 器 的 时 间 。Linux 系统 在 各 种 硬件 上 
的 流行 为 应 用 的 发 布 提供 了 新 的 可 能 ， 应 用 可 以 部 署 在 开发 者 的 机 器 、 云 服务 和 向 入 式 设 
:Ee 


12.5 项 目 


本 章 的 项 目 用 到 了 前 面 提 及 的 多 种 虚拟 化 技术 。 项 目 需要 提前 安装 Git、VirtualBox 
(https:Wwww.virtualbox.org/) 和 Vagrant (http:Wwww.vagrantup.com/)。 只 需 几 个 步骤 就 
可 以 设置 好 Docker (在 一 个 由 Vagrant 管理 的 VirtualBox 上 )。 图 12-3 展示 了 运行 于 OS 
X 系统 之 上 的 Vagrant 文件 ， 定 义 了 一 个 VirtualBox，Docker 实例 运行 在 该 虚拟 机 之 上 。 
Docker 容器 里 安装 一 个 Java SDK， 然 后 就 可 以 在 容器 里 编译 和 运行 Java 程序 了 。 这 个 例 
子 虽然 简单 ， 但 却 包 括 了 安装 更 大 、 更 复杂 的 Docker 容器 所 需 的 全 部 步骤 。 




























































































git clone https://github.com/dotcloud/docker.git 


Vagrantfile VirtualBox VM 
Docker 


Docker Container 


JDK (javac, java) 
Hellojava 














12-3: 让 Java 运行 在 OS X 系统 上 的 Docker 





使 用 Vagrant 安装 Docker (http://docs.docker.com/installation/) 的 方式 因 操 作 系 统 而 异 ， 总 
体 上 来 包括 以 下 步骤 : 


(1) 使 用 Git 抓 取 安 装机 器 所 需 的 包含 Vagrantfile 的 Docker 源码 ， 
(2) 使 用 Vagrant 安装 虚拟 机 ; 
(3) 用 户 通过 ssh 登录 新 建 的 虚拟 机 ， 切 换 到 Docker 用 户 ， 
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(4) Docker 就 绪 后 ， 就 可 以 用 来 创建 和 维护 容器 了 。 





从 宿主 机 器 上 可 以 使 用 Git 下 载 Docker 项 目 : 


git clone https://github.com/dotcLoud/docker .git 
cd docker 


Docker 正在 紧锣密鼓 地 进行 开发 ， 变 化 非常 快 。 初 始 化 安装 后 ， 你 可 以 使 用 Git 更 新 
Docker: 


git pull 




















Docker 为 OS X 系统 提供 了 一 个 受 Vagrant 管理 的 VirtualBox 虚拟 机 。 使 用 如 下 命令 启动 
和 登录 持 有 Docker 的 虚拟 机 .: 





vagrant up 
vagrant ssh 


登录 成 功 后， 键入 exit 可 以 随时 退出 Vagrant 虚拟 机 。 从 Vagrant 管理 的 盒子 里 ， 使 用 如 
下 命令 调用 Docker: 


sudo docker 


使 用 如 下 命令 下 载 并 安装 一 个 基础 的 Ubuntu 镜像 和 一 些 标准 的 Linux 工具 : 





sudo docker pull ubuntu 
sudo docker run ubuntu /bin/echo Docker is running! 


12.5.1 Docker 帮 助 


你 可 以 使 用 内 置 的 帮助 系统 学 习 Docker。 由 于 项 目 变化 很 快 ， 在 线 文 档 可 能 已 经 不 适用 于 
你 当前 使 用 的 版 本 。 键 入 docker 列 出 可 用 命令 ， 添 加 -hetp 参数 列 出 每 个 命令 的 可 选项 : 








docker 
docker build -help 


12.5.2 ”镜像 和 容器 的 维护 
使 用 Docker 工作 一 段 时 间 后 ， 会 积 失 下 一 些 镜像 和 容器 。 使 用 info 命令 给 出 系统 信息 报 
告 ， 其 中 包括 容器 和 镜像 的 数量 ， 








docker info 





报告 中 包括 了 总 数 、 已 退出 的 容器 和 中 间 镜 像 ， 人 们 通常 对 这 些 东 西 感 兴趣 。 容 器 退出 后 
依然 存在 ， 直 到 手动 将 其 删除 。 镜 像 可 以 迅速 累积 ， 因 为 它们 创建 于 Docker 文件 中 定义 
的 每 一 步 。ps 命令 列 出 了 运行 的 Docker 容器 ，images 命令 列 出 了 镜像 (不 包括 那些 用 于 
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构建 的 中 间 镜 像 ) : 


docker ps 
docker images 


使 用 -a 列 出 所 有 的 容器 和 镜像 ， 加 入 -viz， 使 用 GraphViz (http://www.graphviz.org/) 可 


查看 镜像 的 .dot 


使 用 docker inspect <container name> 可 查看 更 为 详细 的 容器 信息 。 使 用 rm 命令 清理 








/说 








docker ;images -viz > docker1.dot 














SN 
” 








器 和 镜像 。 命 令 可 以 串 行 执 行 : 


docker rm $(docker ps -a -q) 
docker rmi $(docker images -q) 


12.5.3 在 Docker 里 使 用 Java 

Docker 的 Git 库 包 含 了 一 个 Vagrantfile 文件 ，Vagrant 使 用 该 文件 建立 和 配置 虚拟 机 。 
Docker 使 用 Dockerfile 建立 和 配置 容器 。FROM 指令 表示 新 虚拟 机 的 基础 镜像 。 有 一 些 公共 
镜像 库 可 供 使 用 ， 或 者 你 也 可 以 选择 使 用 自己 的 镜像 。MAINTAINER 指明 了 镜像 作者 ，RUN 


指令 





























在 当前 镜像 上 运行 命令 并 返回 结果 。 下 面 几 步 安 装 了 Oracle 的 Java 7 SDK， 并 接受 其 











授权 方式 。ADD 指令 将 Hello.java 复制 到 容器 中 ， 它 将 在 那里 被 编译 和 执行 : 





FROM ubuntu:precise 
MAINTAINER Casimir Saternos 


RUN echo "deb http://ppa.Launchpad.net/webupd8team/java/ubuntu precise main"\ 

| tee -a /etc/apt/sources.list 

RUN echo "deb-src http://ppa.Launchpad.net/webupd8team/java/ubuntu precise main"\ 
| tee -a /etc/apt/sources.list 

RUN apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys EEA14886 
RUN apt-get update 


RUN echo oracle-java7-installer shared/accepted-oracle-license-v1-1 select true\ 
| /usr/bin/debconf-set-selections 

RUN apt-get -y install oracle-java7-installer 

RUN update-alternatives --display java 

RUN echo "JAVA _ HOME=/usr/Llib/jvm/java-7-oracle" >> /etc/environment 

ADD Hello.java Hello.java 

RUN javac Hello.java 


在 Dockerfile 所 在 目录 创建 一 个 简单 的 Hello World 程序 : 


public class Hello{ 
public static void main (String args[]){ 
System.out.println("hey there from java" ); 
} 
} 
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有 了 Dockerfile 和 Java 类 ， 就 能 从 镜像 开始 构件 容器 了 。-t 选项 指定 了 库 名 ， 在 列 出 可 用 
镜像 时 会 看 到 : 





docker build -t cs/jdk7 . 
另外 ， 前 面 安装 过 的 JDK 也 安装 好 了 ， 使 用 如 下 命令 执行 复制 到 Docker 容器 中 的 程序 : 


docker run cs/jdk7 java -version 
docker run cs/jdk7 java Hello 


需要 说 明 的 是 ， 这 些 命令 是 在 Docker 容器 里 执行 的 。 在 Vagrant 虚拟 机 里 执行 会 得 到 不 同 
的 结果 (显示 虚拟 机 中 未 安装 Java) : 


java -version 
java Hello 


通过 为 上 述 Dockerfile 增加 新 的 定义 ， 可 以 配置 出 能 以 WAR 形式 运行 在 Jetty 上 的 Web 应 
用 。 使 用 ADD 命令 可 以 将 文件 从 Vagrant 虚拟 机 复制 到 Docker 容器 ， 使 用 RUN 命令 能 运行 
wget 或 其 他 实用 工具 从 指定 URL 下载 需要 的 文件 : 











ADD rest-jersey-server.war rest-jersey-server .war 
RUN wget http://repo2.maven.org/[*…… 真实 路 径 见 脚注 …… ]/jetty-runner .jar 





























将 文件 复制 到 Vagrant 

你 或 许 想 知道 rest-jersey-server.war 是 怎样 到 Vagrant 虚拟 机 上 的 ， 或 者 聪明 如 你 ， 已 
经 使 用 Curl 或 者 wget 下 载 了 它 。 从 网 上 下 载 是 个 不 错 的 选择 ， 但 通过 文件 共享 或 使 
用 scp 也 能 复制 文件 。 

默认 情况 下 ，Vagrant 共享 了 Vagrantfile 的 所 在 目录 到 虚拟 机 中 的 /vagrant 目录 。 此 
外 ，Vagrant 默认 使 用 SSH 协议 (从 端口 22 到 2222)， 因 此 可 以 在 宿主 机 器 和 虚拟 机 
之 间 使 用 scp 复制 文件 。 比 如 ， 使 用 如 下 命令 将 宿主 机 器 上 的 docker.png 复制 到 虚拟 
机 ， 弹 出 需要 密码 的 提示 时 输入 vagrant: 


scp -P2222 vagrant@localhost:docker.png . 











然后 就 可 以 从 镜像 构件 一 个 容器 ， 并 且 使 用 它 了 : 





docker build -t cas/restwar . 


docker run -p 49005:49005 -name restwarcontainer cas/restwar \ 
java -jar jetty-runner-8.1.9.v20130131.jar \ 
--port 49005 rest-jersey-server .War 

















注 2: 该 URL 路 径 太 长 ， 不 支持 换行 ， 其 地 址 是 http://repo2.maven.org/maven2/org/mortbay/jetty/jetty-runner/ 
8.1.9.v20130131/jetty-runner-8.1.9.v20130131.jar。 














需要 注意 的 是 ， 虽 然 容 器 在 交互 运行 ， 但 还 可 以 继续 打开 其 他 vagrant ssh 会 话 执行 寺 
他 命令 。 如 果 你 不 需要 以 交互 方式 运行 Web 应 用 ， 那 么 启动 应 用 服务 器 的 命令 需要 是 
Dockerfile 中 的 最 后 一 个 RUN 指令 。 


-| 





默认 情况 下 ，Docker 会 为 新 启动 的 容器 起 一 个 名 字 。 使 用 -name 选项 可 以 为 容器 起 一 个 有 
意义 的 名 字 ， 但 这 就 额外 引入 了 需要 人 工 干 预 的 步骤 。 如 果 需 要 重新 运行 上 述 命令 启动 容 
器 ， 则 必须 重新 命名 容器 或 删 掉 之 前 创建 的 容器 : 











ID=$(docker ps -a | grep restwar | awk '{print $1}') 
docker rm $ID 


12.5.4 ”Docker 和 Vagrant 的 网 络 设置 

在 OS 义 或 Windows 上 使 用 Docker 的 困惑 之 一 是 ， 它 包括 一 台 机 器 和 两 层 虚 拟 化 ， 如 表 
12-2 所 示 。Vagrant 安装 于 物理 机 之 上 ， 提 供 了 一 个 完整 的 虚拟 机 ，Docker 容器 运行 于 该 
虚拟 机 之 上 。 从 不 同位 置 可 以 看 到 不 同 的 卫 地 址 ， 有 一 些 端口 必须 打开 。 









































表 12-2: 项 目 服务 器 


服务 器 描述 

宿主 机 器 包括 VirtualBox 软件 ， 使 用 Vagrant 管理 
Vagrant 实例 包含 一 个 VirtualBox Linux 虚拟 机 ， 上 面 安 装 有 Docker 软件 
Docker 实例 安装 了 Jersey 服务 器 ，Web 应 用 运行 其 上 





























Vagrant 需要 连接 宿主 机 器 上 的 一 个 端口 ， 通 过 该 端口 配置 Vagrant 文件 ， 运 行 Docker 实 
例 的 命令 也 需要 通过 该 端口 。 从 外 面 来 看 ， 宿 主机 器 只 监听 和 响应 该 端口 。 网 络 设 置 的 可 
能 性 很 多 ， 该 例子 只 需要 几 步 就 可 设置 完成 。 














首先 ， 我 们 在 Vagrant 上 打开 一 个 端口 ， 这 样 宿主 机 器 就 能 看 到 上 面 运行 的 是 什么 。 在 虚 
拟 机 上 指定 一 个 端口 和 宿主 机 器 上 的 一 个 端口 共享 ， 这 称 为 炉 口 转发 ， 端 口号 可 以 和 宿主 
机 器 上 的 端口 号 相同 或 不 同 。 在 这 个 例子 中 ， 我 们 通过 修改 Docker 提供 的 Vagrantfile 将 
Vagrant 虚拟 机 上 的 端口 49005 转发 至 宿主 机 器 上 的 相同 端口 : 








Vagrant: :Config.run do |config| 


config.vm.forward_port 49005, 49005 

















在 该 容器 中 运行 前 面 列 出 的 Jetty 中 的 WAR， 可 通过 在 Vagrant 虚拟 机 和 访问 页 面 上 执行 
一 些 命令 获取 ID 和 IP 地址: 





ID=$(docker ps | awk '{print $1}' | grep -v CONTAINER) 
IP_ADDRESS=$(docker inspect $ID | grep IPAddress | awk -F'"' '{print $4}') 
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echo SID 
echo $IP_ADDRESS 
curl $IP_ADDRESS 








这 里 的 卫 地 址 只 在 Vagrant 虚拟 机 内 部 有 效 ， 外 面 是 看 不 到 的 。 这 时 ， 在 Vagrantfile 中 指 
定 的 端口 转发 就 起 作用 了 。 在 宿主 机 器 上 ， 通 过 浏览 器 访问 http://localhost:49005/ 就 能 看 
到 WAR 的 主页 。 


12.6 ”小结 


20 世纪 80 年 代 , “虚拟 现实 ” 因 Jaron Lanier 变 得 流行 起 来 。 从 那 以 后 ， 电 影 、 视 频 游戏 
和 复杂 的 仿真 系统 都 受益 于 虚拟 现实 的 发 展 ， 对 现实 世界 的 虚拟 化 也 对 计算 机 从 业者 产生 
了 深刻 的 影响 ， 他 们 开始 考虑 如 何 将 计算 机 硬件 虚拟 化 。 


Java 的 成 功 很 大 程度 上 归根 于 Java 虚拟 机 一 一 一 个 屏蔽 了 底层 操作 系统 细 方 的 抽象 层 。 
Servlet 容器 和 JEE 应 用 服务 器 更 进一步 ， 提 供 了 更 高 级 别 的 抽象 。 更 高 级 别 的 抽象 让 专业 
化 程度 更 高 ， 这 就 抹 去 了 中 间 层 的 很 多 问题 。 使 用 现代 化 的 虚拟 技术 能 让 客户 端 - 服务 器 
端 应 用 轻松 运行 于 高 扩展 性 的 方案 之 上 ， 而 且 因 其 结构 化 、 隔 离 化 的 架构 ， 进 行 分 别 打 包 
和 部 署 也 很 容易 。 虽 然 不 能 完全 等 同 ， 但 那些 可 以 提供 和 底层 系统 类 似 功能 的 技术 存在 着 
明显 的 优势 。 


引用 一 个 虚构 角色 的 话 来 为 本 章 开篇 再 合适 不 过 了 。 电 影 中 一 个 引 人 注 目的 角色 一 一 无 论 
多 讨 人 喜欢 ， 总 归 和 真人 是 不 同 的 。 即 便 如 此 ， 虚 可 化 还 是 能 以 某 些 形式 模拟 底层 技术 ， 
从 某 些 角 度 看 起 来 ， 和 它 模拟 的 物理 世界 别 无 二 致 。 
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测试 和 文档 





“没有 语言 ， 思 想 就 像 一 处 模糊 、 人 迹 罕 至 的 星云 。 在 语言 出 现 之 前 ， 没 有 什么 
是 清楚 的 





詹姆斯 林 德 是 一 位 18 世纪 的 苏格兰 医生 。 在 英国 皇家 海军 服役 时 ， 他 完成 了 一 项 实验 ， 
该 实验 现在 被 认为 是 历史 上 第 一 次 药物 临床 试验 。 他 将 12 名 生病 的 水 手 分 成 两 组 ， 分 别 
提供 不 同 的 食物 和 治疗 方式 ， 他 发 现 柑 橘 和 柠檬 能 有 效 预 防 坏 血 病 。 现 在 我 们 知道 坏 血 病 
是 由 于 缺乏 维生素 C 造成 的 ， 这 中 间 整 整 经 历 了 一 个 世纪 ， 人 们 做 着 类 似 的 实验 ， 直 到 
1912 年 ， 卡 西 米 尔 ' 冯 克 才 提 出 “维他命 ”一 词 。 





临床 试验 是 科学 方法 中 的 一 步 。 牛 津 词典 (http://www.oxforddictionaries.com/us/definition/ 
american_english/scientific-method?q=scientifictmethod) 这 样 定 义 科 学 方法 : 这 是 自 17 世 
纪 就 莫 定 了 自然 科学 基础 的 一 种 流程 ， 包 括 系 统 的 观察 、 测 量 和 实验 ， 然 后 形成 假设 ， 测 
试 并 修改 它 。 这 个 定义 虽然 准确 ， 但 是 却 没 有 抓 住 重 复试 验 最 重要 的 输出 ， 将 对 于 现象 的 
描述 和 假设 以 清晰 、 明 确 的 语言 表达 出 来 。 测 试 最 好 能 得 出 对 所 测 对 象 清晰 、 简 洁 的 描 
述 ， 这 样 有 利于 在 后 续 研 究 中 清楚 地 交流 。 


软件 测试 也 有 类 似 的 历史 渊源 ， 它 采用 了 过 去 四 百年 里 自然 科学 中 一 直 沿 用 的 流程 。 测 试 
是 用 来 证 明 或 推翻 假设 的 。 拿 软件 测试 来 说 ， 就 是 假设 全 部 或 部 分 系统 功能 按照 描述 的 方 
式 工作 。 软 件 测 试 还 能 发 现 如 何 更 好 地 设计 应 用 ， 使 应 用 更 加 模块 化 、 结 构 化 。 另 外 ， 软 
件 测试 还 有 助 于 明确 需求 ， 用 精确 的 语言 描述 待 测试 系统 。 
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13.1 测试 的 种 类 

大 多 数 软件 开发 项 目 都 宣称 是 经 过 测试 的 ， 但 这 究竟 意味 着 什么 忍 怕 就 不 那么 显而易见 
了 。 测 试 是 一 个 宽 谤 的 概念 ， 根 据 测试 结 果 、 测 试 创建 方式 、 整 个 系统 的 测试 百分比 以 及 
参与 测试 的 人 员 和 角色， 可 将 测试 划分 为 不 同 的 种 类 。 


13.1.1 “正式 ” 与 “ 非 正 式 ” 

当 测 试 目的 不 是 很 明确 ， 也 不 要 求 测试 结果 非常 正式 时 ， 就 可 采用 随机 测试 。 这 和 在 
REPL 里 练习 编程 类 似 。 它 为 其 他 测试 热身 ， 也 是 一 种 开始 接触 不 熟悉 应 用 的 方式 。 正 式 
的 验收 测试 则 与 此 相反 ， 它 结构 化 、 有 组 织 、 定 义 清晰 ， 专 门 用 于 决定 客户 是 否 应 该 接受 
该 系统 。 非 正式 测试 通常 是 手动 测试 ， 正 式 测 试 则 是 高 度 自动 化 的 。 


与 记 住 一 堆 测 试 种 类 和 方法 论 相 比 ， 更 重要 的 是 理解 测试 目的 ， 在 无 需 引 入 不 必要 开销 的 
情况 下 选择 一 种 对 项 目 来 说 足够 严谨 的 测试 方法 。 如 图 13-1 所 示 ， 测 试 的 正式 程度 可 以 用 
一 根 连 续 的 箭头 描述 ， 这 中 间 有 各 种 可 能 性 。 虽 然 本 章 提 到 了 科学 方法 ， 但 项 目测 试 方式 
的 选择 更 像 是 一 门 艺术 ， 而 非 科 学 。 















软件 测试 的 正式 程度 





非 正式 











图 13-1: 测试 的 正式 程度 


13.1.2 ”测试 范围 

测试 范围 差异 很 大 。 简 单 的 冒 烟 测试 (或 者 健全 测试 ) 仅仅 能 确保 系统 没有 明显 的 破坏 性 
缺陷 ， 而 穷尽 测试 则 可 以 测试 系统 的 方方面面 。 可 以 从 不 同 角度 量化 系统 的 测试 范围 。 测 
试 覆 盖 率 分 析 给 出 了 代码 的 哪些 行 被 单元 测试 跑 到 了 。 即 使 系统 的 测试 覆盖 率 是 100%， 
依然 需要 穷尽 所 有 的 输入 组 合 方 能 说 这 是 一 个 穷尽 测试 。 很 少 有 项 目 能 做 到 这 点 ， 即 使 那 
些 宣称 做 到 的 或 许 也 只 是 针对 系统 的 功能 测试 。 

非 功 能 性 的 属性 也 应 测试 ， 包 括 负 和 载 测 试 、 压 力 测试 、 多 平台 、 多 浏览 器 、 多 设备 测试 。 


云 部 署 扩大 了 测试 的 边界 ， 包 括 主动 引入 系统 失败 来 保证 系统 的 可 恢复 能 力 。 比 如 Netflix 
公司 的 Chaos Monkey 项 目 (http://techblog.netflix.com/2012/07/chaos-monkey-released-into- 
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wild.html) 就 运行 在 Amazon Web 服务 之 上 ， 其 通过 终结 自动 伸缩 群 中 的 虚拟 机 实例 来 检 
验 系统 是 否 能 承受 服务 器 的 失效 。 





13.1.3 谁 来 测 ? 测 什么 ? 为 谁 测 

测试 的 时 间 、 方 式 、 创 建 者 和 受众 都 是 要 重点 考虑 的 内 容 。 开 发 人 员 在 编写 代码 之 前 就 编 
写 好 了 单元 测试 ， 或 者 在 编写 好 代码 后 再 添加 单元 测试 。 黑 金 测试 通常 需要 测试 人 员 编 写 
更 高 级 别 的 功能 测试 。 单 元 测试 和 实现 代码 紧密 相关 ， 而 黑 盒 测试 则 不 需要 考虑 软件 的 内 
部 结构 。 高 度 的 独立 测试 或 许 能 验证 系统 的 某 一 细微 方面 ， 而 集成 测试 则 可 以 保证 相关 系 
统 的 接口 之 间 没 有 缺陷 。 


也 可 以 从 谁 创建 测试 并 评估 结果 的 角度 来 看 待 测试 ， 开 发 者 首先 看 到 测试 结果 ， 然 后 是 
QA 分 析 师 ， 最 终 到 达 决 定 是 否 接 受 这 个 系统 的 决策 者 手中 。 测 试 可 由 不 同 的 人 编写 ， 包 
括 测 试 人 员 和 开发 者 。 测 试 是 根据 需求 创建 的 ， 因 此 需要 最 大 限度 地 让 定义 需求 的 业务 分 
析 师 和 业务 和 干系 人 参与 进来 。 事 实 上 ， 定 义 好 测试 有 助 于 开发 一 套 通 用 的 、 没 有 歧义 的 语 
言 ， 便 于 系统 测试 人 员 进 行 交流 。 


13.2 ”测试 反映 了 组 织 的 成 熟 度 


在 实践 中 ， 对 软件 系统 的 需求 可 能 来 自 多 处 并 以 多 种 形式 存在 。 虽 然 文档 被 认为 是 需求 的 
主要 来 源 ， 但 不 是 所 有 的 项 目 都 有 正式 的 文档 。 即 使 项 目 有 正式 的 需求 定义 和 系统 描述 ， 
在 一 个 处 于 开发 活跃 期 的 系统 里 ， 如 果 不 是 自动 生成 或 有 意 维 护 ， 这 些 文档 也 很 快 就 会 过 
期 。 程 序 员 的 记忆 和 代码 中 的 注释 描述 了 系统 期 望 的 行为 ， 没 有 这 些 ， 可 能 就 只 有 代码 能 
用 来 描述 系统 功能 了 。 人 们 之 所 以 认为 测试 是 系统 之 外 最 能 精确 定义 软件 需求 的 ， 无 法 获 
取代 码 是 主要 原因 。 






























































事实 上 ， 一 组 定义 良好 的 测试 ， 即 使 在 实现 系统 的 原始 代码 被 取代 后 ， 依 然 能 够 工作 。 从 
这 个 角度 来 看 ， 测 试 比 在 建 系统 本 身 更 长 入 、 更 有 价值 。 它 们 是 在 组 织 之 间 、 干 系 人 之 间 
沟通 系统 状态 和 功能 的 高 效 方式 。 


13.2.1 使 用 软件 能 力 成 熟 度 模 型 评价 流程 

Conway 法 则 (http:/www.melconway.com/Home/Conways_Law.html) 表明 : 设计 系统 的 组 
织 ， 其 设计 结果 都 是 对 所 在 组 织 交流 结构 的 复制 。 也 可 以 这 样 阅 ， 一 个 组 织 的 软件 测试 状 
态 反 映 了 软件 流程 的 成 熟 度 (从 软件 流程 的 定义 到 控制 )。 软 件 能 力 成 熟 度 模型 (Capability 
Maturity Model, CMM, https://resources.sei.cmu.edu/asset_ files/TechnicalReport/1993_005_0O01 
_16211.pdf) 定义 了 各 阶段 的 成 熟 度 结构 ， 用 以 描述 软件 开发 和 维护 流程 中 反映 出 的 工艺 稳 
定性 和 组 织 纪 律 性 ， 如 表 13-1 所 示 。 
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表 13-1: 软件 能 力 成 熟 度 模 型 的 各 个 阶段 
































级 别 名 称 描述 测试 

级 别 1 ”初始 级 不一致、 无 组 织 没有 测试 或 进行 随意 测试 

级 别 2 ”可 重复 。 规范 的 流程 有 一 些 单元 测试 

级 别 3 ”已 定义 ”标准 的 、 一 致 的 流程 ”统一 的 项 目 ， 每 次 构建 都 运行 单元 测试 
级 别 4 ”已 管理 ”可 预测 的 流程 寺 续 集成 测试 

级 别 5 优化 中 不断 改进 流程 覆盖 率 、 代 码 质量 、 报 告 











高 度 优化 的 组 织 对 团队 中 英雄 人 物 的 依赖 度 更 低 ， 更 不 容易 错过 最 终日 期 、“ 死 亡 之 旅 ” 
(http://en.wikipedia.org/wiki/Death_march_(project_management)) 和 其 他 代表 项 目 失去 控制 
的 现象 。 关 注 应 用 的 扩展 性 ， 就 有 可 能 忽略 组 织 的 扩展 性 。 














如 果 想 让 组 织 获 得 长 期 发 展 ， 则 需要 更 高 级 别 的 软件 成 熟 度 模型 。 统 一 的 流程 和 程序 能 i 
新 成 员 更 快 地 融入 组 织 。 生 产 效率 高 的 成 员 有 时 要 放下 工作 ， 花 时 间 教 授 新 成 员 一 些 内 部 
的 、 未 文档 化 且 非 强制 执行 的 惯常 做 法 ， 而 统一 的 流程 能 将 这 一 时 间 最 小 化 。 统 一 的 流程 
还 能 减少 新 员工 有 可 能 给 现 有 系统 带 来 的 不 稳定 性 。 在 最 佳 情况 下 ， 好 的 流程 能 教会 员工 
一 些 方法 ， 这 些 方 法 同样 适用 于 其 他 尚未 被 充分 掌控 的 项 目 。 



































13.2.2 ”使 用 Maven 促 进 流 程 统 一 

直接 说 服 人 们 采用 统一 的 软件 开发 实践 很 难 ， 而 使 用 工具 推动 实践 向 组 织 目标 靠拢 就 容易 
得 多 。 比 如 ，Maven 引入 了 一 致 的 构建 周期 ， 它 通过 插件 提供 了 扩展 的 灵活 性 ， 且 不 至 于 
和 很 多 最 佳 实践 偏离 太 多 。 





























Maven 的 目标 之 一 是 提供 统一 的 构建 系统 (http:/maven.apache.org/what-is-maven.html) 。 
和 Gradle 或 者 其 他 构建 工具 相 比 ，Maven 可 能 不 够 灵活 。 统 一 性 或 多 或 少 会 让 软件 有 点 
伪 硬 ， 但 不 能 简单 地 说 僵硬 就 是 政 亚 的 ， 应 该 避免 的 。 必 须 做 出 决定 ， 实 现 那 些 有 利于 组 
织 内 部 流程 统一 的 结构 和 工具 。 结 构 化 的 测试 和 报告 流程 是 最 基本 的 ， 适 用 于 大 多 数 软件 
项 目 。 











Maven 默认 包含 两 阶段 测试 (测试 和 集成 测试 )。 如 图 13-2 所 示 ， 测 试 位 于 Maven 其 他 
构建 环节 的 中 间 。 通 常情 况 下 ， 测 试 阶 段 会 使 用 Surefire 插件 (http://maven.apache.org/ 
Surefire/maven-surefire-plugin/) ， 集 成 测试 阶段 则 使 用 Failsafe 插件 (http:/maven.apache. 
org/surefire/maven-failsafe-plugin/)。 可 使 用 Surefire Report 插件 (http://maven.apache.org/ 
surefire/maven-surefire-report-plugin/) 以 HTML 格式 显示 Surefire 和 集成 测试 报告 。 








Maven 的 构建 生命 周期 是 推动 项 目 统一 化 的 方式 之 一 ， 默 认 包 含 单元 测试 和 集成 测试 两 
个 阶段 。 它 们 处 于 流程 的 中 间 ， 生 成 的 文档 可 发 布 到 统一 的 地 方 (Maven 网 站 )。 上 默认 阶 
段 提 供 了 一 个 良好 的 基本 框架 ， 如 有 需要 ， 可 在 此 基础 之 上 扩展 Maven， 处 理 其 他 测试 
情况 。 
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默认 Maven 构 建生 命 周 期 各 阶段 


二 














依赖 于 部 署 好 的 

人 mm 汪 叶 
他 形式 的 包 的 测试 加 电路 安装 

待 打包 和 部 署 的 和 





代码 上 的 单元 测 
试 是 不 可 靠 的 == 集成 测试 


mm 打包 


编译 
合法 性 验证 











13-2: Maven 构建 生命 周期 


Maven 可 在 持续 集成 (Continuous Integration，CI) 服务 器 上 周期 性 地 执行 应 用 的 单元 
测试 ， 作 为 构建 流程 的 一 部 分 。 这 样 的 服务 器 很 多 ， 如 开源 的 Jenkins (http://jenkins-ci. 
org/)， 商 用 软件 Team City (http://www.jetbrains.com/teamcity/) 和 Bamboo (https:Wwww. 
atlassian.com/software/bamboo)。 持 续集 成 服务 器 提倡 标准 的 软件 开发 最 佳 实践 。 持 续集 成 
服务 器 要 求 使 用 版 本 控制 系统 ， 鼓 励 合理 维护 Maven 资产 ， 并 能 够 快速 反映 出 构建 能 否 在 
合理 时 间 内 完成 。 


























持续 集成 服务 器 可 将 Maven 报告 (http://maven.apache.org/plugins/maven-source-plugin/ 
project-reports.html) 发 布 到 指定 地 址 。 这 些 报告 展示 了 代码 的 结构 和 质量 ， 同 时 也 让 测试 
结果 一 目 了 然 ， 包 插 编 写 了 多 少 条 测试 、 执 行 结果 、 性 能 和 总 体 上 的 代码 覆盖 率 。 





避免 追求 100% 的 覆盖 率 

人 们 一 旦 使 用 覆盖 率 报告 ， 就 很 容易 为 追求 100% 的 测试 覆盖 率 而 忽视 测试 
本 身 的 价值 。 覆 盖 率 工具 覆盖 了 那些 会 被 执行 的 代码 路 径 。 现 实 中 ， 有 些 代 
码 路 径 永远 不 会 执行 ， 还 有 一 些 则 根本 不 值 一 测 。 因 此 测试 覆盖 率 不 等 于 测 
试 质量 。 究 其 本 质 ， 测 试 只 能 证 明 有 问题 ， 不 能 证 明 没 问题 。 过 份 强 调 测试 
覆盖 率 会 让 程序 员 做 出 曲 意 着 迎 的 改动 ， 而 软件 质量 则 没有 任何 提高 。 

JUnit 的 制定 者 意识 到 人 们 有 过 份 追 求 测试 覆盖 率 的 趋势 ， 也 知道 有 些 代 
码 根本 就 不 需要 测试 。 他 们 在 FAQ (http://junit.sourceforge.net/doc/faq/faq. 
htm#tests_6) 中 有 人 句 座右铭 : 


“ 当 担 心 变 为 麻烦 时 再 进行 测试 。 


























一 个 组 织 可 通过 使 用 Maven 将 单元 测试 集成 到 所 有 项 目 中 并 将 项 目 构建 都 放 在 持续 集成 服 
务 器 上 的 方式 ， 迅 速 到 达 软 件 能 力 成 熟 度 模型 3 级 。 发 布 测试 结果 有 助 于 开发 团队 之 间 沟 
通 软件 状态 和 相关 测试 情况 。 虽 然 Maven 支持 手写 文档 ,但 是 并 没有 涵盖 将 需求 和 测试 相 
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关联 的 机 制 。 


通过 持续 记录 项 目 统计 信息 ， 可 以 不 断 地 改善 流程 、 更 好 地 审视 项 目 。 和 代码 复杂 性 、 测 
试 覆盖 率 、 代 码 行 数 、 重 复 代码 、 注 释 和 违反 编程 实践 相关 的 数据 是 客观 可 度量 的 ， 可 使 
用 类 似 SonarQube (http://www.sonarqube.org/) 这 样 的 产品 ， 将 这 些 信息 保存 到 数据 库 中 。 
这 有 助 于 识别 代码 质量 的 变化 趋势 ， 是 逐渐 改善 还 是 不 断 退化 。 

















13.2.3 ”使 用 行为 驱动 开发 促进 流程 统一 

非 正 规 测试 通常 是 为 了 找 出 缺陷 或 使 系统 失灵 。 这 样 的 测试 需要 保留 ， 经 常 性 地 运行 这 样 的 
测试 可 保证 问题 不 在 日 后 重 现 。 构 建 系 统 时 经 常 运行 的 一 组 单元 测试 能 为 应 用 的 后 续 支持 提 
供 非常 高 效 的 安全 保障 。 但 是 不 应 扳 立 地 看 待 测试 ， 而 应 将 它们 和 软件 开发 的 其 他 方面 融 为 
一 体 。 可 参考 1993 年 Steve McConnell 在 《代码 大 全 》(Code Complete， 英 文 版 由 Microsoft 
Press 出 版 ，http:/www.cc2e.com/Default.aspx) 一 书 中 的 话 :“ 在 写 方法 时 ， 想 想 该 如 何 测试 。 
在 你 编写 单元 测试 ， 或 是 测试 人 员 独 立 测试 你 的 方法 时 ， 这 样 的 想法 都 是 有 益 的 。 


值得 注意 的 是 ， 边 设计 边 测试 会 带 来 更 好 、 更 结构 化 的 代码 ， 更 好 的 命名 和 其 他 的 好 处 。 
它 表明 测试 和 软件 开发 生命 周期 的 其 他 阶段 关系 紧密 ， 它 还 预测 了 最 近 的 软件 测试 实践 。 
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测试 驱动 开发 (Test-Driven Development，TDD) 采取 了 编写 代码 时 考虑 测试 的 想法 ， 事 
实 上 ， 是 在 编写 相关 代码 前 先 编写 测试 。 具 体 来 说 ，TDD 遵循 这 样 一 个 循环 : 先 写 一 个 失 
败 的 测试 来 描述 新 需求 ， 然 后 编码 、 重 构 ， 直 到 测试 成 功 。 

















随后 ，Dan North 引入 了 行为 驱动 开发 (Behavior-Driven Development，BDD)， 帮 助 开 
发 者 更 好 地 理解 该 从 何 处 开始 TDD: 测 什么 ?对 于 给 定 测试 应 该 输入 什么 ?如 何 命名 ? 
BDD 以 一 种 描述 性 的 方式 架 起 了 代码 和 人 类 语言 之 间 的 桥梁 。TDD 给 测试 的 创建 方式 以 
更 开放 的 空间 ， 而 BDD 沿袭 了 TDD 的 工作 流 ， 但 是 提供 了 更 正规 的 格式 用 以 描述 行为 。 
BDD 的 成 功 需要 组 织 中 的 个 人 勇于 承担 ， 同 时 它 也 有 一 些 方面 和 较 高 的 CMM 水 平 相关 。 
BDD 要 求 团队 之 间 的 交流 。 质 量 保证 测试 人 员 、 开 发 者 和 商业 分 析 师 必须 高 效 协作 。 带 来 的 
好 处 是 相关 测试 用 例 直 接 和 需求 联系 在 一 起 ， 并 且 使 用 一 种 通用 、 无 歧义 的 语言 进行 表达 。 












































使 用 Maven 和 一 些 成 熟 的 测试 框架 ， 可 以 为 开发 者 引入 了 一 致 的 组 织 和 结构 。BDD 鼓励 
开发 者 进行 交流 并 持续 改进 流程 ， 而 不 仅 限于 测试 和 需求 的 收集 定义 。 





13.3 ”测试 框架 


测试 方式 由 测试 软件 决定 。JUnit (http:/junit.org/) 用 来 做 Java 的 单元 测试 ， 而 JavaScript 的 
单元 测试 使 用 Jasmine (http://pivotal.github.io/jasmine/)。JBehave (http://jbehave.org/) 是 Java 
的 行为 驱动 开发 框架 ， 而 Cucumber (http://cukes.info/) 则 是 Ruby 的 行为 驱动 开发 框架 。 
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13.3.1 _ JUnit 

JUnit (http://junit.org/) 最 初 由 Erich Gamma 和 Kent Beck 编写 ， 它 发 展 迅速 ， 从 最 开始 的 简 
单 框架 发 展 到 了 已 经 相当 复杂 的 JUnit4。 在 以 前 的 版 本 中 ， 单 元 测试 归属 特定 的 对 象 层次 ， 
方法 名 也 必须 遵守 命名 规范 以 便 能 正常 工作 。 像 Java 生态 系统 中 的 很 多 项 目 一 样 ，JUnit4 
使 用 了 大 量 注释 。 比 如 ， 不 显 式 创建 setup() 和 tearDown() 此 类 方法 ， 而 是 使 用 @before 和 
@after 注释 去 标注 这 些 在 测试 前 后 需要 执行 的 代码 。@beforeClass 和 @afterClass 用 来 标注 
在 类 初始 化 前 和 初始 化 后 要 执行 的 代码 。@Test 替换 掉 了 以 前 方法 名 以 “test” 开 头 的 惯例 ， 
而 @ignore 取代 了 注释 掉 单 元 测试 的 讨厌 做 法 。 因 为 对 象 层次 中 已 经 没有 assert 方法 了 ， 
所 以 需要 导入 那些 静态 断言 类 。 断 言 还 可 用 来 标明 带 参 数 的 测试 或 一 组 测试 。 





















































TestNG 
在 过 去 几 年 中 ， 另 外 一 种 引起 人 们 注意 的 Java 单元 测试 框架 是 TestNG (http://testng. 
org/doc/index.html) 。 它 和 现在 的 JUnit 功能 类 似 ， 但 以 前 它 有 一 些 JUnit 没有 的 功能 ， 
比如 带 参数 的 测试 。 此 外 ， 它 还 能 更 好 地 管理 一 组 测试 。 这 为 高 效 集成 测试 带 来 了 灵 
活性 。 有 些 开发 者 喜欢 TestNG 的 约定 ， 同 时 也 喜欢 JUnit 中 的 注释 。 














单元 测试 通常 和 主 程序 使 用 同样 的 编写 语言 。 这 样 做 的 好 处 显而易见 ， 那 就 是 能 轻松 地 执 
行 具体 的 独立 方法 或 应 用 的 函数 。 随 着 单元 测试 的 普及 ， 它 逐渐 成 为 开发 者 之 间 用 来 沟通 
的 “文档 ”。 这 个 项 目 是 怎么 工作 的 ? ““ 看 看 单元 测试 就 知道 了 。” 遗 憾 的 是 ， 编 程 语言 
不 能 帮助 那些 非 程序 员 清 楚 地 理解 系统 是 如 何 工作 的 。 在 很 多 情况 下 ， 即 使 掌握 编程 语言 
的 程序 员 也 无 法 从 测试 中 获取 需求 。 











Jasmine 和 Cucumber 用 来 实现 BDD， 这 在 很 大 程度 上 支持 了 自然 语言 。Jasmine 使 用 
JavaScript 编写 测试 ， 而 Cucumber 从 根本 上 说 是 一 门 名 为 Gherkin 的 小 巧 语言 的 解释 器 。 
Gherkin 是 一 种 商业 可 读 的 DSL， 描 述 了 软件 的 行为 。 实 际 用 来 测试 应 用 的 代码 被 单独 写 
在 另外 的 文件 中 。 








13.3.2 Jasmine 


Jasmine (http://pivotal.github.io/jasmine/) 使 用 JavaScript 字符 串 和 函数 来 描述 需求 。 它 又 
小 又 轻 ， 因 此 很 容易 和 项 目 集 成 ， 只 需 打 开 浏 览 器 就 能 运行 。 基 本 的 测试 结构 包括 对 测试 
的 描述 ， 甚 后 的 块 包含 了 期 望 ， 其 实质 是 对 返回 结果 是 true 还 是 false 的 断言 。 按 惯例 ， 
这 些 代 码 存放 在 一 个 名 为 Spec 的 JavaScript 文件 中 ， 打 开 SpecRunner.html 运行 测试 ， 该 
页 面包 含 相关 的 依赖 类 库 : 
























































describe("Suite Title Here", function() { 
it("Expectation (assertion) Title Here", function() { 
expect(true).toBe(true); 
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二) 
}); 
虽然 接近 自然 语言 ， 但 测试 还 是 用 JavaScript 来 编写 ， 在 那些 没 受过 专业 训练 的 人 看 来 ， 
就 像 是 人 类 语言 中 参 杂 了 大 量 的 符号 。 外 行 可 能 会 问 :“ 为 什么 最 后 两 行 末尾 的 符号 看 起 
来 如 此 悲伤 ? ” 











13.3.3 Cucumber 


Cucumber 基于 一 种 名 为 Gherkin 的 DSL， 它 和 自然 语言 很 像 。 比 如 login.feature 是 一 个 结 
构 化 的 文本 文件 ， 里 面 有 一 些 关 键 词 和 规整 的 对 齐 : 





Feature: Login 
As a user, 
I want to be able to Log ;in with correct credentials 


Scenario: Success login 


Given correct credentials 
When I load the page 
Then I should be able to log in 


和 每 一 步 功能 相对 应 的 代码 实现 都 是 单独 维护 的 : 


Given(/^correct credentials$/) do 
end 


When(/^I load the page$/) do 
Capybara.visit(VALID_LOGIN_URL) 
end 


Then(/^I should be able to log in$/) do 
Capybara.page.has_content?('To NOT Do') 
end 








正则 表达 式 用 来 匹配 测试 描述 中 的 文本 。Ruby 代码 用 来 执行 真正 的 测试 。 这 个 例子 中 ， 
使 用 Capybara 可 自动 打开 浏览 器 ,访问 一 个 URL， 然 后 判断 期 望 的 内 容 是 否 出 现 。 











摘自 The Cucumber Book' 


Cucumber 有 助 于 促进 团队 成 员 发 现 并 使 用 一 种 通用 语言 进行 交流 ， 如 此 一 来 程序 员 和 
非 程序 员 均 可 使 用 此 语言 。Cucumber 测试 使 用 一 种 业务 干系 人 能 读 懂 的 语言 进行 纺 
写 ， 同 时 可 直接 和 开发 者 的 代码 交互 。 大 家 共同 编写 测试 ， 分 工 协作 ,项 目 成 员 不 仅 
要 决定 接 下 来 需要 实现 的 行为 ， 而 且 学 会 使 用 一 种 大 家 都 明白 的 通用 语言 来 描述 行为 。 





注 1: 参见 https://pragprog.com/book/hwcuc/the-cucumber-book。 
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测试 框架 可 以 直接 调用 或 通过 构建 工具 进行 调用 。 本 章 所 示 项 目 均 可 作为 Maven 构建 的 一 


部 分 运行 。 


13.4 项 目 


本 章 所 示 项 目 (https://github.com/java-javascript/client-server-web-apps/tree/master/Chapter- 


人 展示 了 如 何 将 JUnit 和 Jasmine 测试 集成 进 Maven 构建 。 这 


其 中 





还 包括 了 Cucumber 测试 ， 使 用 Capybara 调用 Selenium 来 作为 一 个 浏览 器 自动 化 功能 测试 


的 BDD 例子 。 


为 了 避免 实现 一 个 常规 的 、 落 入 俗套 的 “ 待 办 事项 ”应 用 ， 该 项 目 包 含 一 个 “ 打 死 也 不 
干 ”Web 应 用 ， 如 图 13-3 所 示 。 该 应 用 可 以 用 来 列 出 人 们 不 想 干 的 事 。 亲 爱 的 读者 朋友 





们 ， 你 们 是 不 是 觉得 我 这 个 想法 很 新 新 别致 呢 ? 





To NOT Do 


Key Priority Description Last Updated 
Add/Update 
1 1 procrastinate 12/23/2013 此 到 
08:06:15 
2 1 make more lists 12/23/2013 区 浊 
08:0623 
3 2 code in cobol 12/23/2013 区 浊 
0806:52 
4 2 Use maven to cal ruby to call 12/23/2013 最 浊 
ant 0807:46 
5 3 stare at the Screen for more 12/23/2013 攻 汪 
than 10 minutes 0808:12 
6 5 drink coffee outof5 gallon 12/23/2013 区 浊 
buckets 08:08:45 
学 4 send json in http get request 12/23/2013 加 
bodies 08:1104 











图 13-3: 打 死 也 不 干 Web 应 用 


该 项 目 展 示 了 在 Maven 构建 全 过 程 中 调用 的 各 种 测试 框架 。 最 终 的 结果 是 一 个 网 站 ， 包 括 





了 测试 报告 和 相关 文档 。 
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13.4.1 JUnit 
对 于 任何 Maven 项 目 ， 其 配置 的 出 发 点 都 应 是 pom.xml。 依 赖 部 分 引入 了 JUnit， 它 在 测 
试 时 会 用 到 : 


13. 





<groupId>junit</groupId> 
<artifactId>junit</artifactId> 
<version>4.11</version> 
<scope>test</scope> 


4.2 Jasmine 








和 在 pom.xml 中 引入 JUnit 做 Java 单元 测试 的 方式 一 样 ， 需 要 引入 另外 的 依赖 来 支持 
JavaScript 测试 。 本 项 目 使 用 了 Justin Searls 负责 维护 的 Jasmine Maven 插件 : 





<groupId>com.github.searls</groupId> 
<artifactId>jasmine-maven-plugin</artifactId> 
<version>1.3.1.3</version> 


项 目 包 含 一 个 测试 样 例 ， 用 来 验证 所 依赖 类 库 是 否 存在 ， 功 能 是 否 正常 : 








describe("Validate moment.min.js", function() { 


it("expects moment.min.js to be functional", function() { 

expect( 
moment("20111031", "YYYYMMDD" ) . 
format('MMMM Do YYYY, h:mm:ss a') 

) .toBe( 

"October 31st 2011, 12:00:00 am" 
和 
]); 
]); 


除了 要 在 Maven 中 声明 依赖 ， 还 需要 额外 配置 引入 JavaScript 文件 。 如 果 配 置 正 确 ， 使 用 
mvn install 就 能 运行 测试 了 : 


[INFO] 
JASMINESPECS 
[INFO] 

Suite Title Here 


Expectation (assertion) Title Here 


Validate moment.min.js 
expects moment.min.js to be functional 


Results: 2 specs, 0 failures 





Jasmine 插件 在 很 多 情况 下 都 是 完美 的 解决 方案 。 但 是 与 浏览 器 相关 的 代码 无 法 运行 ， 这 
限制 了 插件 适用 性 。 浏 览 器 自动 化 更 适合 需要 大 量 DOM 操作 的 测试 。 使 用 类 似 Selenium 
(http://docs.seleniumhq.org/) 的 方案 可 在 多 六 览 器 上 进行 测试 。 浏 览 器 自动 化 让 训 览 器 的 





特性 得 以 暴露 出 来 。 在 





Java 单元 测试 中 可 以 直接 使 用 Selenium， 但 很 多 情况 下 ， 浏 览 器 


自动 化 测试 要 求 级 别 更 高 的 功能 或 集成 测试 。 使 用 类 似 Capybara (http://jnicklas.github.io/ 
capybara/) 这 样 的 高 级 类 库 作 为 Selenium 的 驱动 类 控制 浏览 器 是 非常 高 效 的。 下 面 这 个 
Cucumber 的 例子 (http://cukes.info/) 就 是 这 样 使 用 Capybara 的 。 








13.4.3 Cucumber 


/ruby 目录 包含 一 个 Ruby 版 的 登录 测试 。Gemfile 列 出 了 依赖 ，webapp_steps.rb 包含 处 理 




















功能 文件 中 所 定义 的 需求 的 代码 。 使 用 如 下 命令 可 启动 应 用 : 


mvn jetty:run 


打开 另 一 个 会 话 ， 运 行 Cucumber: 


cd ruby 
CUCUmber 


列 出 的 功能 会 逐个 运行 ， 





输出 显示 了 每 一 步 的 执行 情况 ， 如 





吏 





13-4 所 示 。 








Cs-MacBook-Air:ruby cs$ cu 
Feature: Login 

As a user, 

I want to be able to log 


Scenario: Success login 
Given correct credenti 
When I load the page 
Then I should be able 


Feature: WebService 
As a user, 
I want to be able to log 


Scenario: Success add/1i 
Given correct credenti 
When I add and list To 
Then the returned list 


2 scenarios (2 passed) 
6 steps (6 passed) 
Q@m3.912s 





cumber 


in with correct credentials 


# features/login.feature:5 
als # features/step_definitions/webapp_steps.rb:18 
# features/step_definitions/webapp_steps.rb:22 
to log in # features/step_definitions/webapp_steps.rb:26 


in, add and and list the feature through the API 


st # features/webservice.feature:5 

als # features/step_definitions/webapp_steps.rb:18 
Not Do items # features/step_definitions/webapp_steps.rb:32 
should contain the item I added # features/step_definitions/webapp_steps.rb:37 








图 13-4: 运行 Cucumber 


13.4.4 Maven 报 告 


本 章 的 pom.xml 文件 比 





BB 中 其 他 项 目 里 的 文件 长 很 多 。 大 量 和 核心 应 用 无 关 的 依赖 和 插件 


需要 在 测试 时 用 到 。 而 且 》 还 有 一 些 配置 用 于 将 信息 发 布 到 Maven 项 目 网 站 。 


使 用 Maven 的 网 站 插件 生成 一 个 网 站 ， 运 行 在 8080 端口 : 
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mvn site:site 
mvn site:run 


Maven 的 /site/ 目录 包含 很 多 资源 文件 ， 可 用 来 定制 网 站 。 在 图 13-5 中 ， 通 过 添加 一 个 
site.xml 来 定制 “皮肤 ”， 为 网 站 提供 了 不 同 的 风格 。 

















ToNOTdo 


Last Published: 2013-12-23 | Version: 1.0-SNAPSHOT 





Project Documentation Project Summary 


Project Information 


About 
Project Team 
Dependency Information 
Project Plugins 
Continuous Integration 
Issue Tracking 

Source Repository 
Project License 

Plugin Management 
Distribution Management 


Project Summary 


Project Information 

Field Value 
ToNOTdo 

Description An application to track things you want to avoid or stop doing. 


Name 


Homepage - 


Project Organization 


This project does not belong to an organization. 


Build Information 


Mailing Lists 
Field Value 


Groupld 
ArtifactId to-not-do-app 


Dependencies 


Project Reports com.saternos.tonotdo 


Built by: “Ww 


maven Version 1.0-SNAPSHOT 
Type war 
JDK Rev 1.6 











13-5: 打 死 也 不 干 Maven 网 站 


13.5 ”小结 


软件 的 可 扩展 性 需要 架构 良好 、 可 预测 且 高 性 能 的 系统 ， 而 测试 保证 了 这 种 系统 的 开发 。 
单元 测试 、Maven 和 持续 集成 相关 系统 通过 明确 开发 流程 、 掌 握 应 用 状态 促进 了 这 种 系统 
的 开发 。 





组 织 的 可 扩展 性 需要 流程 规范 且 沟 通 流畅 。 上 述 工 具 和 BDD 类 的 方法 共同 为 团队 带 来 了 
测试 的 益处 ， 确 保 及 时 反馈 软件 的 质量 。 

软件 测试 基于 物理 学 中 提炼 出 的 科学 方法 和 实践 ， 这 为 软件 提供 了 客观 的 支持 。 如 果 使 用 
得 当 ， 测 试 为 展示 应 用 的 质量 和 性 能 提供 了 实用 价值 ， 并 促进 在 需求 是 如 何 实 现 的 这 一 问 
题 上 达成 共识 。 








“生命 就 是 一 个 分 布 式 系统 。 人 与 人 之 间 通 过 一 个 分 布 式 、 超 媒体 系统 进行 交流 ， 
人 类 的 智能 、 上 声音 和 手势 、 视 觉 和 听觉 ， 还 有 想象 ， 都 是 其 中 的 组 件 。 
一 一 罗 伊 .T. 菲 尔 丁 


最 初 打 算 写 书 时 脑海 里 仅仅 有 个 大 概 的 计划 ， 现 在 回头 看 看 最 终 的 结果 ， 感 觉 这 是 一 段 令 
人 着 迷 的 经 历 。 虽 然 和 我 的 最 初 预想 略 有 出 入 ， 但 本 书 还 是 忠于 了 早先 介绍 的 主题 
化 。 在 第 1 章 我 们 指出 ， 由 于 技术 的 革新 ， 世 界 发 生 了 巨大 的 变化 ， 这 在 很 多 领域 是 显 而 
易 见 的 。 而 且 变化 的 速度 在 最 近 几 年 变 得 越 来 越 快 。 一 个 大 型 项 目 ， 在 其 上 线 之 日 起 就 变 
成 了 一 个 遗留 系统 ， 这 种 事 已 经 司空 见 惯 了 。 


试图 迎合 所 有 的 创新 或 者 选择 完全 忽略 它们 ， 这 两 种 极端 反应 都 是 目光 短 浅 且 徒 劳 无 用 
的 。 更 好 的 面 对 方式 是 找 出 那些 真正 改变 游戏 规则 的 因素 。 本 书 着 重 反 映 了 一 些 Java 开 
发 者 会 碰 到 的 问题 ， 这 需要 他 们 更 为 深入 地 进行 研究 。 有 两 种 基本 途径 可 应 对 持续 改变 的 
Web 开发 方式 ， 即 从 更 广大 的 开发 社区 和 前 人 经 验 中 进行 学 习 。 


14.1 社区 


其 他 语言 社区 有 着 完全 不 同 的 观点 ， 因 此 可 以 启发 Java 开发 社区 产生 不 同 的 创新 。 总 体 
上 来 说 ，Java 开发 者 基础 牢固 ， 但 有 时候 有 点 固步自封 。 他 们 能 从 在 JavaScript、Ruby 和 
Python 等 语言 上 成 长 起 来 的 其 他 社区 那里 学 到 很 多 (同时 也 能 贡献 很 多 )。 很 多 伟大 的 想 
法 一 经 实现 ， 便 可 应 用 于 其 他 更 为 广泛 的 领域 。 一 种 环境 下 的 新 奇想 法 ， 可 能 在 另 一 种 环 
席 下 就 成 了 革命 性 的 概念 。 














变 








到 
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14.2 历史 


第 二 点 是 对 过 去 的 了 解 。 当 代 文 化 对 新 事物 总 是 不 假 思索 地 接受 ， 实 际 上 更 好 的 做 法 是 对 
创新 保持 开放 的 心态 ， 从 一 个 更 广阔 的 视野 上 评估 其 价值 。 计 算 机 科学 和 软件 开发 历史 虽 
短 ， 但 内 容 却 很 丰富 。 创 造 了 “面向 对 象 ”这 一 术语 并 发 明了 Smalltalk 语言 的 计算 机 科学 
家 艾 伦 . 凯 (Alan Kay，http:Wwww.drdobbs.comyarchitecture-and-design/interview-with-alan- 
kay/240003442) 曾经 指出 (http:Wwww.bitly/leUUzKE) ， 现 代 计 算 机 科学 和 软件 开发 的 很 
多 方面 表现 出 和 流行 文化 (http://ubm.io/leQNBrD) 相近 的 趋势 ， 不 关心 也 不 了 解 过 去 。 
很 多 重要 的 、 持 和 久 的 想法 其 来 有 自 ， 几 年 前 其 至 几 十 年 前 就 已 经 存在 了 。 如 有 可 能 ， 我 们 
最 好 站 在 巨人 的 肩膀 上 ， 从 过 去 所 犯 的 错误 中 学 习 。 






































“在 过 去 25 年 左右 的 时 间 里 ， 我 们 有 点 朝 着 流行 文化 的 方向 发 展 ， 就 像 电视 发 明 
之 初 ， 一 些 发 明 电视 的 人 认为 这 是 一 种 向 大 众 普及 莎士比亚 的 新 方式 。 但 是 他 们 
忘记 了 那些 看 电视 的 人 首先 要 学 养 丰 富 ， 能 看 得 懂 莎 士 比 亚 。 电 视 所 能 做 的 只 是 
让 人 们 看 ， 至 于 能 看 出 什么 来 就 是 他 们 的 事 了 。 


因此 ， 我 认为 现在 之 所 以 缺乏 真正 的 计算 机 科学 和 软件 工程 ， 部 分 要 归 和 处于 这 种 
流行 文化 。” 


14.3 尾声 


我 希望 读者 能 或 多 或 少 从 本 书 中 学 到 点 什么 。 能 在 这 样 一 个 时 代 从 事 软 件 开发 是 件 令 人 兴 
奋 的 事 ， 时 代 的 变化 带 来 了 前 所 未 有 的 机 遇 。 新 技术 层出不穷 ,永远 有 解决 不 完 的 问题 。 
阅读 本 书 ， 练 习 其 中 的 项 目 能 成 为 其 中 一 步 ， 希望 这 是 你 们 中 某 些 人 的 第 一 步 ， 让 您 从 中 
获 益 ， 并 且 创 造 出 新 的 系统 ， 让 这 个 世界 变 得 更 加 美好 。 我 将 引用 伟大 的 数学 家 和 老师 乔 
治 . 波 利 亚 的 话 给 读者 们 留 作 思 雳 。 乔 治 ' 波 利 亚 聪明 过 人 ， 但 他 认识 到 人 性 和 个 人 因素 
在 解决 问题 中 的 作用 ， 这 对 于 软件 开发 同样 适用 。 















































“认为 解决 问题 是 一 种 纯粹 的 “智力 活动 ”是 错误 的 ， 决 心 和 情感 在 其 中 也 起 了 
重要 作用 。 不 温 不 火 、 懒 洋洋 地 费 些 功 夫 也 许 足 以 解决 一 些 课堂 上 遇 到 的 常规 问 
题 ， 但 是 对 于 严肃 的 科学 问题 ， 唯 有 意志 力 才能 引领 你 经 受 住 长 年 累 月 的 艰辛 和 
挫折 …… 教 授 如 何 解决 问题 ， 就 是 在 教 你 如 何 培养 自己 的 意志 力 。 





乔治 ， 波 利 亚 
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随 着 时 间 的 推移 ， 人 机 界面 风格 已 经 变化 繁多 ， 并 且 这 种 变化 是 基于 有 问题 的 设备 特性 以 
及 看 似 有 些 随 意 的 趋势 。 命 令 行 界 面 (Command-Line Interfaces，CLI) 曾 是 20 世纪 90 年 
代 之 前 与 操作 系统 交互 的 主要 手段 ， 之 后 ， 它 逐渐 因为 图 形 化 操作 系统 以 及 可 视 化 互联 网 
的 主导 而 黯然 失色 。 尽 管 外 观 相 对 简陋 ， 但 CLI 仍然 深 受 欢迎 ， 因 为 它 提供 的 功能 可 能 是 
GUI 不 具备 的 。 


CLI 提供 的 交互 模式 类 似 于 电 传 打印 机 (这 是 种 从 电报 机 演变 而 来 的 小 玩意 儿 ， 用 于 发 送 
键入 的 信息 ) 的 功能 。CLI 比 GUI 更 依赖 于 用 户 的 打字 能 力 。 这 种 限制 其 实 也 是 一 种 优 
势 ， 因 为 CLI 可 以 用 于 编写 脚本 。 大 多 数 的 程序 员 都 在 他 们 所 使 用 的 操作 系统 中 通过 命令 
行 shell 的 方式 体验 过 CLI。 当 涉及 的 任务 越 来 越 多 时 ， 它 可 以 很 轻易 地 将 一 组 命令 打包 到 
一 个 脚本 之 中 ， 这 就 导致 在 许多 脚本 语言 中 都 包含 各 自 的 CLI 作为 执行 环境 。 

也 有 人 将 CLI 称 为 REPL ( 读 取 - 求 值 - 输 出 循环 ，Read-Eval-Print Loop) 或 language 
shell。 无 论 你 怎么 称呼 它 ， 在 执行 给 定 的 表达 式 或 命令 时 ， 它 对 语言 特性 的 探索 及 立即 能 
得 到 反馈 结果 的 特点 都 是 非常 宝贵 的 。 














虽然 Java 本 身 不 包含 CLI (Beanshell 与 其 最 为 接近 ， 要 详细 了 解 Beanshell， 请 参考 http:/ 
www.beanshell.org)， 但 JVM 所 支持 的 语言 ， 如 JRuby、Jython 及 Groovy 等 都 有 自己 的 
CLI。JVM 和 Java 的 紧密 整合 使 得 它 可 以 通过 所 有 这 些 语言 的 CLI 与 原生 的 Java 类 和 模 
块 进行 交互 。 这 种 工作 流 上 的 显著 差异 在 测试 及 调试 时 非常 有 用 。 在 本 章 中 ，JRuby 的 
IRB (交互 式 Ruby shell，Interactive Ruby Shell) 将 通过 JDBC 连接 到 基于 Java 的 数据 库 ， 
并 执行 SQL 查询 。 
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为 什么 不 叫 IRS? 
你 可 能 会 疑惑 为 什么 Ruby 不 把 自己 的 命令 行 界面 称 为 IRS (交互 式 Ruby shell) 。 
Ruby 程序 的 标准 文件 扩展 名 是 .tb。 因 此 “交互 ”加 上 “RB” 就 是 IRB， 











A.1 设置 Gradle 的 使 用 


Gradle 可 用 于 下 载 下 面 脚本 用 到 的 Java 项 目 依赖 。 注 意 这 只 是 出 于 便利 ，Gradle 这 样 的 构 
建 工 具 和 CLI 之 间 没 有 必然 的 联系 。 这 个 Gradle 构建 文件 是 用 gradle setupBuild 生成 的 。 
生成 的 build.gradle 文件 包含 与 使 用 相关 的 注释 。 后 续 会 对 这 个 文件 进行 修改 以 包含 需要 的 
模块 及 相关 插件 ， 还 有 仓库 所 在 的 主机 位 置 : 






































appLy pLugin: 'java' 
appLy plugin:'application’ 


repository{mavenCentral()} 


dependencies{ 

compile 'org.slf4j:slf4j-api:1.7.5" 

compile 'hsqldb:hsqldb:1.8.8.10" 

compile 'com.h2database:h2:1..3.172" 
compile 'net.sf.opencsv:opencsv:2.3" 
compile 'commons-io:commons-io:2.4" 
compile 'org.apache.derby:derby:10.10.1.1" 

testCompile "junit:junit:4.11" 


} 
定义 了 构建 文件 后 ， 可 以 使 用 gradle build 构建 项 目 。 所 需 的 JAR 包 会 被 添加 到 本 地 仓 
库 中 。 再 次 重申 ， 这 里 的 任务 并 不 一 定 需要 Gradle， 你 可 以 使 用 Maven 来 末代 ， 其 至 可 以 
手动 定位 和 下 载 需要 用 到 的 JAR 包 。 我 们 选择 Gradle 是 因为 它 的 语法 很 精简 (与 Maven 
相 比 ) ， 而 手动 下 载 文件 很 容易 出 错 而 且 很 烦琐 。 




















A.2 JRuby IRB 


因为 下 面 的 实例 使 用 了 Java 类 (数据 库 实 现 和 JDBC)， 所 以 需要 一 个 基于 Java 的 Ruby 
版 本 。 其 他 的 实现 将 无 法 使 用 。 如 果 你 正在 使 用 RVM， 若 是 需要 可 以 安装 耻 uby 并 且 选 
择 它 来 使 用 : 
































Srvm use jruby 1.7.4 





如 果 你 还 设 有 安装 过 ， 那 么 先 安 装 gem 包 (本 例 用 的 是 版 本 1.3.5)。 当 它 可 用 之 后 ， 运 行 
bundle init 可 创建 包 所 需 的 Gemfile。 增 加 如 下 3 行 ; 


gem 'jdbc-derby' ，'10.9.1.0' 
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gem 'jdbc-h2', '1.3.170.1' 
gem 'jdbc-hsqldb', '2.2.9.1" 


这 些 gem 包含 了 JRuby 要 用 到 的 JDBC。 运 行 bundle 来 安装 这 些 (Ruby) 依赖 。 





























我 们 已 经 见识 了 通过 Gradle 管理 Java 依赖 ， 以 及 通过 bundler 管理 JRuby 依赖 。 在 JRuby 
中 直接 引用 Java 的 JAR 也 是 可 行 的 。 方 便 起 见 ， 我 们 复制 JAR (在 Gradle 初始 化 时 引入 
的 ) 到 当前 路 径 下 的 一 个 lib 目录 。 这 个 文件 在 你 本 地 的 Gradle 库 中 : 














$ find ~/.gradle -name opencsv-2.3.jar 
$ mkdir Lib 


$ cp <path to jar file from find command>opencsv-2.3.jar lib 


这 个 JAR 在 JRuby 中 可 以 使 用 require 关键 字 来 获取 (这 也 是 通常 用 来 引入 Ruby 文件 的 )。 


IRB 介 绍 
登录 IRB 会 打开 一 个 提示 符 。 具 体 的 提示 符 会 根据 你 当前 使 用 的 Ruby 版 本 而 变化 : 





$ irb 
jruby-1.7.4 :001 > 


在 这 个 提示 符 后 面 ， 你 可 以 输入 一 个 表达 式 ， 并 且 立 即 看 到 执行 结果 : 





2.0.0-p247 :001 > 1 + 4 
一 


你 还 能 检查 对 象 ， 并 找 出 它们 提供 了 什么 方法 。Java 中 的 反射 也 允许 观察 和 操作 对 象 ， 但 
是 略 显 元 长 和 复杂 。 作 为 对 比 ，Ruby 提供 了 简洁 明了 的 方式 来 动态 查询 和 改变 对 象 。 在 
这 方面 的 灵活 性 让 它 的 元 编程 能 力 广为人知 : 


2.0.0-p247 :002 > "Hello World".class 
=> String 


2.0.0-p247 :014 > "Hello World".methods.grep(/sp/).sort 
=> [:display, :inspect, :respond to?, :split] 


2.0.0-p247 :021 > "Hello World".split 
=> ["Hello", "World"] 

















接 下 来 的 例子 会 忽略 相关 提示 和 运行 结果 。 但 是 一 个 命令 运行 之 后 立即 得 到 的 反馈 对 于 
irb 的 交互 具有 巨大 价值 ， 谁 用 谁 知道 。 











在 前 面 的 例子 中 ，Hetlo World 是 一 个 字符 串 (没有 被 指定 到 任何 特定 变量 )。 它 有 大 量 的 
方法 可 以 调用 ， 因 此 这 个 例子 过 滤 (使 用 grep) 和 整理 了 包含 sp 的 方法 。 最 终 ， 以 这 种 
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方式 得 到 的 方法 ， 我 们 可 以 称 为 对 象 (Hello World 字符 串 ) 上 的 方法 ， 并 且 观 察 它 的 作 
用 。 这 种 方法 并 不 是 参考 文档 的 替代 品 ， 但 是 确实 可 以 省 掉 很 多 不 必要 的 查找 。 


A.3 基于 Java 的 关系 型 数据 库 


在 一 个 irb 会 话 中 ， 我 们 现在 可 以 探寻 适用 于 基于 JAVA 的 关系 型 数据 库 的 API。 如 果 你 
使 用 过 JDBC 编写 Java 类 ， 那 么 毫 无 疑问 ， 你 肯定 记得 这 需要 一 定数 量 的 模板 文件 。 除 了 
标准 的 Java 规定 (使 用 main 方法 来 定义 类 ) ， 你 需要 编写 大 量 的 异常 处 理 代 码 (import 语 
句 ， 在 方法 声明 中 的 throws、try/catch 块 )。 这 些 额外 的 语法 需要 添加 显 式 输入 代码 、 少 
量 输出 和 一 些 注释 ， 并 且 一 些 看 似 简单 的 类 会 变 得 更 加 腔 肿 。 幸 运 的 是 ，Ruby 的 语法 比 
较 简 洁 ， 并 且 代 码 编写 的 交互 环境 让 测试 驱动 API 变 得 简单 。 



































这 里 我 们 简单 看 看 3 个 数据 库 : H2、HSQLDB 和 Derby。 从 外 部 看 来 它们 很 类 似 ， 但 
是 在 具体 实现 、 存 储 机 制 、 性 能 和 开源 许可 选项 上 都 存在 不 同 。 每 一 个 数据 库 都 可 以 通 
过 JDBC 访问 ， 在 irb 会 话 中 我 们 会 有 效 地 测试 每 一 种 类 型 的 SQL 语句 ， 如 示例 表 A-1 
所 示 。 


表 A-1: SQL 语句 类 型 











类 型 示例 描述 

Query SELECT 检索 数据 

DDL CREATE、DROP 数据 定义 语言 〈 创 建 、 改 变 或 替代 一 个 数据 库 对 象 ) 
DML INSERT、UPDATE、 DELETE 数据 操作 语言 (修改 数据 ) 





事实 证 明 ， 只 有 你 真正 使 用 这 些 数据 库 时 才能 发 现 它们 之 间 细 微 的 区 别 〈 例 如 SQL 语法 、 
字符 串 连 接 和 结果 集 的 关闭 )。 


为 了 让 这 些 例子 更 加 简洁 ， 我 们 需要 一 份 可 用 于 每 一 类 数据 库 的 通用 代码 ， 它 可 以 添加 
到 文件 中 并 通过 irb 加 载 。 这 里 的 代码 需要 支持 : 使 Java 可 用 ， 能 够 装载 opencsvJAR 
包 (用 于 快速 将 一 个 结果 集 演 染 成 以 逗号 分 隔 的 值 )， 添 加 能 够 执行 SQL (查询 、DML 和 
DDL) 和 显示 SQL 结果 集合 的 函数 。 

















require 'java' 
require 'lib/opencsv-2.3.jar' 


TEMP_FILE="temp.csv" 


def displayResultSet(r) 
writer = Java.AuComBytecodeOpencsv: :CSVWriter.new( 
java.io.FileWriter.new(TEMP_FILE), 
java.lang.String.new("\t").charAt(0) 
) 
writer.writeAll(r, true) 
writer.close() 
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File.open(TEMP_FILE).readlines.each{|line|puts line} 
“rm #{TEMP_FILE}: 
end 


def exec(statement, conn) 
puts statement 
conn.createStatement().execute(statement) 
end 


def execQuery(statement, conn) 
puts statement 


conn.createStatement().executeQuery(statement); 
end 


这 个 文件 实际 上 是 通过 load 'dbutils.rb' 加 载 到 环境 中 的 。 


A.3.1 H2 


Thomas Mueller 创造 H2 (http://h2database.com) 同时 也 大 力 参 与 了 HSQLDB 的 开发 。 下 
面 的 例子 使 用 了 用 户 名 sa 和 空 密码 来 连接 数据 库 test， 然 后 执行 了 SQL 语句。 同时 需要 





注意 的 是 ， 在 创建 表 时 没有 指定 name 列 的 VARCHAR 长 度 。 





Load 'dbutils.rb’ 


require 'jdbc/h2" 
Jdbc::H2.Load_ driver 


conn = java.sqL.DriverManager .getConnection('jdbc:h2:test' ，"sa"，"") 
# VARCHAR does not regquire a length 

exec("CREATE TABLE test (id int, name varchar)", conn) 

exec("INSERT INTO test(id, name) VALUES (1, 'a')", conn) 
displayResultSet(execQuery('select * from test', conn)) 

exec("DROP TABLE test", conn) 


conn.close() 


A.3.2 HSQLDB 


HSQLDB (http://hsqldb.org/) 因为 被 OpenOffice 这 样 的 开源 项 目 以 及 Mathematica 这 


这 相 


的 





商业 项 目 所 引用 而 出 名 。 和 H2 不 同 ， 在 获取 连接 时 它 不 需要 用 户 名 和 密码 ， 而 且 name 列 





使 用 的 VARCHAR 类 型 必须 指定 长 度 。 
Load “dbutiLs.rb' 


require 'jdbc/hsqldb' 
Jdbc: :HSQLDB. Load_driver 


con = java.sql.DriverManager .getConnection('jdbc:hsqldb:test') 
exex("CREATE TABLE test (id, int, name varchar(10)", conn) 
exec("INSERT INTO test(id, name) VALUES (1, 'a')", conn) 
displayResultSet(execQuery('select * from test', conn) 
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exec("DROP TABLE test", conn) 
conn.close() 


A.3.3 Derby 


Derby (http://db.apache.org/derby) 这 个 项 目的 起 源 可 以 追 调 到 20 世纪 90 年代。 它 随 着 
CloudScape、Informix 和 IBM 不 断 涅 重生 。 从 Java 6 开始 ，Sun (后 来 被 Oracle 收购 ) 将 
Derby 作为 Java DB 引入 JDK。JDBC 连接 字符 串 中 的 create=true 属性 表示 在 请 求 连接 时 
如 果 没 有 该 数据 库 就 创建 。 此 外 ，Derby 需要 在 删除 引用 表 之 前 显 式 关 闭 其 结果 集 : 

















Load 'dbutils.rb' 


require 'jdbc/derby' 
Jdbc: :Derby. load_driver 


conn = java.sql.DriverManager .getConnection('jdbc:derby:test;create=true') 
exec("CREATE TABLE test (id int, name varchar(10))", conn) 

exec("INSERT INTO test(id, name) VALUES (1, 'a')", conn) 

rT = execQuery('select * from test', conn) 

displayResultSet(r) 

r.close() 

exec("DROP TABLE test", conn) 

conn.close() 


虽然 上 一 个 例子 聚焦 于 关系 型 数据 库 
可 以 使 用 类 似 的 步骤 来 探索 。 


但 是 显然 任何 Java 库 都 可 以 通过 脚本 来 访问 ， 并 且 











A.4 小 结 


尽管 整个 环境 已 经 开始 走向 图 形 化 ， 但 CLI 提供 的 直接 反馈 输出 还 是 令 其 成 为 一 种 特别 高 
效 的 工具 。 我 们 可 以 通过 在 CLI 环境 中 不 断 试验 的 方式 来 构造 脚本 ,试验 的 过 程 不 仅 消 除 
了 传统 的 构建 步 又 ， 其 至 不 需要 特地 执行 一 个 源 文件 。 这 种 类 型 的 交互 对 于 很 多 开发 者 来 
说 是 易于 理解 的 ， 但 那些 专注 于 Java 的 开发 者 也 许 只 有 有 限 的 接触 经 验 。 现 代 Web 浏览 
器 里 的 JavaScript 控制 台 就 是 一 个 现代 的 CLI 实现 ， 而 且 正 如 本 章 所 阐述 的 ， 在 服务 器 端 
也 有 类 似 的 工具 供 Java 程序 员 使 用 ， 只 需要 进行 简单 设置 即 可 。 
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附录 B 





B.1 


REST 式 的 Web AP| 总 结 


HTTP 1.1 请 求 方法 


表 B-1 总 结 了 HTTP 1.1 的 请 求 方法 (http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html)。 


表 B-1: HTTP 1.1 请 求 方法 


























HTTP 动 词 ”对 资源 采取 的 动作 REST 动 作 

GET 检索 类 似 SQL SELECT 

HEAD “` 带 响应 体 的 检索 类 似 SQL SELECT 1 

POST 创建 (或 扎 加 ) 类 似 SQL INSERT 

PUT 更 新 (或 创建 ) 完整 资源 ”类似 SQL UPDATE (或 不 存在 时 的 INSERT) 
PATCH 部 分 更 新 类 似 SQL UPDATE (部 分 资源 ) 

DELETE 删除 类 似 SQL DELETE 

TRACE Echo 请 求 确定 中 间 服 务 器 修改 的 诊断 

OPTIONS 返回 支持 的 方法 确定 资源 允许 的 HTTP 方法 

CONNECT 支持 HTTP 隧道 支持 HTTP 隧道 技术 


B.2 


HTTP 1.1 响 应 码 





表 B-2 到 表 B-6 总 结 了 HITP 1.1 状态 码 (http:/www.w3.org/Protocolsrfc2616/rfc2616-secl10html) 。 
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表 B-2: 信息 类 状态 码 1xx 











状态 码 ”意义 描述 
100 继续 指示 请 求 已 经 收 到 (而 且 没 有 被 服务 器 拒绝 ) 期 间 的 中 间 响 应 
101 切换 协议 ”服务 器 切换 到 由 UPgrade 请 求 头 定义 的 协议 


表 B-3: 成 功 状 态 码 2xx 



































状态 码 ”意义 描述 

200 OK 被 接受 

201 被 创建 正在 创建 一 个 新 的 资源 

202 被 接受 已 接受 ， 但 是 处 理 还 未 完成 

203 非 权威 信息 ”实体 头 返回 元 数据 的 子 集 或 超 集 

204 无 内 容 不 包含 响应 体 

205 重 置 内 容 客户 端 应 该 发 起 一 个 请 求 来 查看 与 初始 请 求 相 关联 的 资源 
206 部 分 内 容 一 个 包含 了 一 个 range 请 求 头 的 响应 


表 B-4: 重 定向 状态 码 3xx 
























































































































































状态 码 意义 描述 

300 多 个 选项 资源 在 不 同位 置 有 多 种 展现 

301 永久 移动 资源 已 经 分 配 了 一 个 新 的 永久 URI 

302 找到 资源 已 经 分 配 了 一 个 新 的 临时 URI 

303 参考 其 他 请 求 的 响应 在 一 个 不 同 的 URI 下 可 用 

304 未 修改 文档 未 修改 的 条 件 请 求 的 响应 

305 使 用 代理 请 求 的 资源 可 以 通过 返回 的 代理 URI 访问 
306 (未 使 用 ) 当前 的 HTTP 版 本 没有 使 用 

307 临时 重 定 向 ”请 求 的 资源 临时 存在 于 一 个 不 同 的 URI 下 
表 B-5: 客户 端 错误 状态 码 4xx 

状态 码 意 》 描述 

400 坏 请 求 请 求 无 法 理解 

401 未 授权 请 求 没有 授 

402 需要 支付 保留 以 后 使 用 

403 禁 正 请 求 不 允许 〈 即 使 有 附加 授权 ) 

404 未 找到 资源 未 找到 

405 方法 不 允许 指定 URL 的 HTTP 方法 无 效 

406 不 可 接受 可 以 使 用 accept 请 求 头 中 的 内 容 来 生成 资源 
407 需要 代理 验证 请 求 未 验证 〈 需 要 通过 代理 授权 ) 

408 请 求 超时 客户 端 没 有 在 服务 器 指定 的 时 间 里 发 送 请 求 
409 冲突 为 当前 资源 的 状态 无 法 完成 请 求 ( 例 如 ， 因 为 PUT 所 做 的 修改 ) 
410 丢失 资源 不 可 用 

411 需要 长 度 需要 内 容 长 度 头 部 
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沾 


状态 码 ”意义 描述 





412 前 置 条 件 失败 请 求 头 部 的 前 置 条 件 值 为 false 
413 请 求实 体 太 大 请 求实 体 比 服务 器 指定 的 国 值 大 
414 请 求 URI 过 长 请 求 URI 比 服务 器 指定 的 阔 值 长 
415 不 支持 的 媒体 类 型 ”格式 不 支持 

416 请 求 范围 不 满足 。”” 头 部 指定 的 内 容 范围 无 法 处 理 
417 胡 望 失败 请 求 头 部 域 的 期 望 不 满足 

















表 B-6: 服务 器 端 错误 状态 码 5xx 


























状态 码 ”意义 描述 

500 服务 器 内 部 错误 ”服务 器 未 预期 的 错误 情况 

501 未 实现 不 支持 的 功能 

502 坏 网 关 作为 代理 的 服务 器 收 到 了 来 自 上 游 服务 器 的 无 效 响应 
503 服务 不 可 用 服务 器 临时 不 可 用 

504 网 关 超时 代理 服务 器 未 收 到 上 游 服务 器 的 及 时 响应 





505 HTTP 版 本 不 支持 ”请求 信息 中 的 HITP 协议 版 本 不 支持 


B.3 Curl Web API 


Curl (http://curl.haxx.se/) 实用 工具 可 以 使 用 各 种 不 同 协议 与 服务 器 传输 数据 。 表 B-7 展示 





了 使 用 该 工具 的 命令 行 选项 子 集 就 可 以 完成 的 大 部 分 HTTP REST 式 的 Web API 操作 。 


表 B-7: 精 选 的 HTTP 相 关 的 Curl 选 项 





选项 “名称 ”描述 
-HH 头 部 名 定 一 个 HTTP 头 部 





-d 数据 发 送 指定 的 字符 串 数据 到 服务 器 

-5 静默 选项 ”不 显示 进度 表 和 错误 信息 

-L 位 置 如 果 服 务 器 响应 带 有 位 置 头 部 和 3xx 响应 状态 码 ， 则 在 新 位 置 上 重 
新 发 送 请 求 (使 用 - -max-redirs 限制 重 定向 ) 

-xX 执行 选项 ”指定 HTTP 请 求 方法 


















































-A 代理 指定 用 户 代 理 

-b Cookie 指定 cookie (- -cookie 比 -b 更 容易 记忆 ) 

-0 输出 输出 到 一 个 文件 (或 者 使 用 -0 按照 远程 请 求 的 名 字 写 入 一 个 文件 ) 
调用 示例 : 


curl -s -H "Accept: application/json" \ 
-H "Content-Type: application/json" \ 
http://Llocalhost:8080/hello/world \ 

-X PUT -d '{"hello": "world"}' 
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B.4 JSON 语 法 


JSON 是 一 种 简单 的 数据 交换 格式 ， 是 JavaScript 的 子 集 。 





JSON 类 型 





数组 《有 序 、 方 括号 包 衷 的 喜 号 隔 开 的 值 ) 
对 象 〈 无 序 、 喜 号 隔 开 的 键 值 对 集合 ) 
数字 

字符 串 

布尔 值 

Null 





B.5 铁路 图 

















下 
了 更 为 正式 的 描述 。 
B.5.1 ”对象 


JSON 对 象 是 一 组 由 花 括 号 包 右 的 零 个 或 多 个 字符 串 对 及 其 关联 值 的 集合 。 所 有 的 字符 串 
都 跟着 一 个 冒号 ， 后 面 是 其 关联 值 。 如 果 字 符 串 值 对 不 止 一 个 ， 则 会 使 月 









































B-1 所 示 。 





看 的 铁路 图 (http://bottlecaps.de/rr/ni) 对 组 成 JSON 数据 交换 格式 的 JavaScript 子 集 进行 











有 逗号 阳 开 ， 如 图 




















B 


JSON 数组 是 由 方 括号 包 于 的 由 逗号 隔 开 的 值 的 列表 ， 如 区 


B-1: 对 象 


.5.2 ”数组 

















B-2 所 示 。 














B-2: 数组 
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B.5.3 值 
值 可 以 为 字符 串 、 数 字 、 对 象 、 数 组 、true、fatse 或 者 null， 如 图 B-3 所 示 。 











串 


四 














B-3: 值 
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Casimir Saternos 有 十 余年 软件 开发 经 验 ， 曾 为 Java Magazine 和 Oracle Technology Network 
撰写 技术 文章 ， 参 与 录制 了 几 期 Peepcode screencasts。 现 在 ， 他 主要 使 用 Java、Ruby 等 技 
术 从 事 Web 应 用 开发 。 





关于 封面 图 


本 书 封 面 上 的 动物 是 印度 灵猫 (Viverra zibetha) 。 这 种 哺乳 动物 分 布 于 东南 亚 的 草原 和 密 
林 ， 其 中 包括 缅 向 、 泰 国 、 束 埔 寨 、 马 来 西亚 和 中 国 南 方 地 区 。 





大 印度 灵猫 喜 独 居 ， 夜 间 最 为 活跃 ， 豆 食 小 急 、 蛇 、 青 蛙 以 及 相对 较 小 的 哺乳 动物 。 它 也 
食用 水 果 和 树 根 ， 但 以 肉食 为 主 。 印 度 灵 猫 白 天 往 于 洞穴 中 (常常 是 其 他 动物 挖掘 和 废弃 
不 用 的 洞穴 ) 。 


大 印度 灵猫 身长 20~37 英寸 (不 包括 尾巴 的 长 度 )。 它 的 毛皮 呈 灰 褐色 ， 颈 部 和 尾部 有 黑 
色 条 纹 。 峻 性 灵猫 比 雄 性 灵猫 略 小 ， 可 随时 交配 (一 般 一 年 生 两 胎 ， 独 自 抚养 后 代 ) 。 


灵猫 香 是 灵猫 的 排泄 物 ， 用 于 标识 领地 。 稀 释 后 的 灵猫 香 (通常 采集 自 非洲 灵猫 ) 几 个 世 
纪 以 来 都 被 用 作 香 水 的 定理 剂 。 很 多 现代 产品 中 已 经 开始 使 用 人 工 合成 的 灵猫 香 ， 但 是 还 
有 几 种 灵猫 被 非法 捕捉 以 获取 其 内 和 臭 腺 。 


封面 图 片 来 自 Lydekker 的 Natural History。 
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欢迎 加 入 


图 灵 社 区 ITuring.cn 





最 前 沿 的 IT 类 电子 书 发 售 平台 


电子 出 版 的 时 代 已 经 来 临 。 在 许多 出 版 界 同 行 还 在 犹豫 入 得 的 时 候 ， 图 灵 社 区 已 经 采取 实 
际 行动 拥抱 这 个 出 版 业 巨 变 。 作 为 国内 第 一 家 发 售 电子 图 书 的 开 类 出 版 商 ， 图 灵 社 区 目前 为 读者 
提供 两 种 DRM-free 的 阅读 体验 :在线 阅读 和 PDF。 

相 比 纸 质 书 ， 电 子 书 具 有 许多 明显 的 优势 。 它 不 仅 发 布 快 ， 更 新 容易 ， 而 且 尽 可 能 采用 了 彩 
色 图 片 ( 即使 有 的 书 纸 质 版 是 黑白 印刷 的 )。 读 者 还 可 以 方便 地 进行 搜索 、 剪 贴 、 复 制 和 打印 。 

图 灵 社 区 进一步 把 传统 出 版 流程 与 电子 书 出 版 业务 紧密 结合 ， 目 前 已 实现 作 译 者 网 上 交 
稿 、 编 辑 网 上 审 稿 、 按 章 发 布 的 电子 出 版 模式 。 这 种 新 的 出 版 模式 ， 我 们 称 之 为 “人 敏捷 出 
版 ”， 它 可 以 让 读者 以 较 快 的 速度 了 解 到 国外 最 新 技术 图 书 的 内 容 ， 弥 补 以 往 翻 译 版 技术 书 
“出 版 即 过 时 ”的 缺憾 。 同 时 ， 敏 捷 出 版 使 得 作 、 译 、 编 、 读 的 交流 更 为 方便 ， 可 以 提前 消炎 
书稿 中 的 错误 ， 最 大 程度 地 保证 图 书 出 版 的 质量 。 



























































| 









































优惠 提示 : 现在 购买 电子 书 ， 读 者 将 获 赠 书 款 20% 的 社区 银子 ， 可 用 于 免 换 纸 质 样 书 。 


一 一 最 方便 的 开放 出 版 平台 


图 灵 社 区 向 读者 开放 在 线 写 作 功 能 ， 协 助 你 实现 自 出 版 和 开源 出 版 的 梦想 。 利 用 “合集 ” 
功能 ， 你 就 能 联合 二 三 好 友 共 同 创作 一 部 技术 参考 书 ， 以 免费 或 收费 的 形式 提供 给 读者 。( 收 
费 形式 须 经 过 图 灵 社 区 立项 评审 。 ) 这 极 大 地 降低 了 出 版 的 门槛 。 只 要 你 有 写作 的 意愿 ， 图 灵 
社区 就 能 帮助 你 实现 这 个 梦想 。 成 熟 的 书稿 ， 有 机 会 人 选 出 版 计划 ， 同 时 出 版 纸 质 书 。 

图 灵 社 区 引进 出 版 的 外 文 图 书 ， 都 将 在 立项 后 马上 在 社区 公布 。 如 果 你 有 意 翻译 哪 本 图 
书 ， 欢 迎 你 来 社区 申请 。 只 要 你 通过 试 译 的 考验 ， 即 可 签约 成 为 图 灵 的 译 者 。 当 然 ， 要 想 成 功 
地 完成 一 本 书 的 翻译 工作 ， 是 需要 有 坚强 的 毅力 的 。 


最 直接 的 读者 交流 平台 


在 图 灵 社 区 ,你 可 以 十 分 方便 地 写作 文章 、 提 交 勘 误 、 发 表 评 论 ， 以 各 种 方式 与 作 译 者 、 
辑 人 员 和 其 他 读者 进行 交流 互动 。 提 交 勘 误 还 能 够 获 赠 社区 银子 。 

你 可 以 积极 参与 社区 经 常 开展 的 访谈 、 乐 译 、 评 选 等 多 种 活动 ， 赢 取 积 分 和 银子 ， 积 累 个 人 
声望 。 
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图 灵 最 新 重点 图 书 
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Node 与 Express 开发 
书号 : 978-7-115-38033-3 
定价 : 69.00 元 


了 大 数据 权威 著作 全 新 升级 版 ! 
> 第 1 版 畅销 40000 册 ! 


本 书 源 自作 者 在 斯 坦 福 大 学 教授 的 “海量 数据 挖掘 ” 
( CS246: Mining Massive Datasets ) 课程 ， 第 1 版 上 市 以 来 
受到 读者 广泛 欢迎 和 认可 。 本 书 以 大 数据 环境 下 的 数据 
挖掘 和 机 融 学 习 为 重点 ， 全 面 介 绍 了 实践 中 行 之 有 效 的 
数据 处 理 算法 ， 是 在 校 学 生 和 相关 从 业 人 员 的 必 备 读物 。 
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全 端 Web 开 发 : 使 用 JavaScript 与 Java 


近 几 年 来 ， 用 户 习 惯 、 技 术 和 开发 方法 极 大 地 改变 了 Web 应 用 的 设计 ， 
但 是 Web 本 身 并 没有 变化 。 本 书展 示 了 如 何 开 发 出 遵循 Web 底 层 架构 的 
应 用 。 





作为 一 名 Java 程 序 员 ， 在 以 客户 端 一 服务 器 端 架 构 开 发 Web 应 用 时 ， 如 
何 应 对 各 种 难题 ? 这 本 内 容 详 尽 的 指南 将 告诉 你 如 何 使 用 各 种 Java 工 
具 、 客 户 端 技 术 和 Web API 开 发 Web 应 用 。 作 者 首先 概括 了 客户 端 一 服 
务 器 端 技术 ， 然 后 详细 介绍 了 很 多 实用 的 客户 端 一 服务 器 端 架 构 。 你 将 
在 多 个 章节 中 参与 到 实战 项 目 中 ， 从 而 获得 对 相应 技术 和 主题 的 第 一 手 


通过 阅读 本 书 ， 你 将 


加 ed 包括 代码 组 织 和 快速 原型 开 
发 ， 


国 探索 JavaScript 开 发 中 用 到 的 各 种 主流 工具 、 框 架 和 起 点 项 目 ; 
目 深入 学 习 Web API 设 计 和 REST 风 格 的 软件 架构 ; 
加 了 解 有 别 于 传统 打包 方法 的 各 种 Java 打 包 方 式 ， 以 及 应 用 服务 器 


“ 随 着 客户 端 一 


服务 器 端 架构 向 
浏览 器 迁移 ， 现 在 的 程序 员 面 
临 着 来 自 新 技术 和 架构 的 挑战 。 
这 本 书 直 的 这 一 复杂 性 的 核心 ， 
将 Web 应 用 开发 的 现状 直接 呈 
现在 读者 眼前 。” 
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Technology Network 上 发 表 过 技 
术 文 章 ， 可 在 Pluralsight (www. 
pluralsight.com) 上 观看 他 录制 





的 部 署 ; 的 Peepcode 播 客 视频 。 他 目前 
四 使 用 轻 量 级 服务 器 构建 项 目 ， 涉 及 jQuery 和 Jython、Sinatra 和 主要 使 用 Java、Ruby 等 技术 从 事 
Web 应 用 开发 。 
Angular; 
四 使 用 传统 Java Web 应 用 服务 器 和 类 库 构建 客户 端 一 服务 器 端 Web 
应 用 。 
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